darcs

Patch 953 Infrastructure to convert markdown files... (and 10 more)

Title Infrastructure to convert markdown files... (and 10 more)
Superseder Nosy List bf, kowey
Related Issues
Status followup-requested Assigned To bf
Milestone

Created on 2012-09-29.17:01:16 by kowey, last changed 2015-02-05.15:43:37 by bf.

Files
File name Status Uploaded Type Edit Remove
infrastructure-to-convert-markdown-files-in-doc-to-long-help-text_.dpatch kowey, 2012-09-29.17:01:15 application/x-darcs-patch
patch-preview.txt kowey, 2012-09-29.17:01:15 text/x-darcs-patch
unnamed kowey, 2012-09-29.17:01:15
unnamed kowey, 2014-11-15.19:37:29 text/html
See mailing list archives for discussion on individual patches.
Messages
msg16140 (view) Author: kowey Date: 2012-09-29.17:01:15
11 patches for repository http://darcs.net:

Continuing the effort to divorce the documentation and help text
from the rest of the source code.  Is this the way to go in principle?

Mostly sending this because I tend to work on it in bits and bobs
and then find myself very out of date, and have to spend a lot of
time rebasing.  So maybe I should give you what I have now in case
I flake out and wander off again.

Sat Sep 15 10:23:20 BST 2012  Eric Kow <kowey@darcs.net>
  * Infrastructure to convert markdown files in doc to long help text.
  
  The aim is to make the documentation easier to maintain by putting it
  all in one place, using one format.  This change brings us closer to
  the idea of documentation being in its own tree apart from the source
  code while still avoiding some duplication between the manual and the
  online help text.

Sat Sep 29 09:13:25 BST 2012  Eric Kow <kowey@darcs.net>
  * Use Printer.Doc in prompts.
  
  This allows us to get closer to converge user messages to Doc.

Sat Sep 29 09:13:32 BST 2012  Eric Kow <kowey@darcs.net>
  * Move darcs send help block to doc dir.

Sat Sep 29 09:13:35 BST 2012  Eric Kow <kowey@darcs.net>
  * Move darcs whatsnew messages to doc and Darcs.UI.Message.WhatsNew.

Sat Sep 29 10:53:32 BST 2012  Eric Kow <kowey@darcs.net>
  * Reindent and slightly tidy Darcs.UI.Commands.Send.

Sat Sep 29 13:48:40 BST 2012  Eric Kow <kowey@darcs.net>
  * Move darcs revert messages to doc and Darcs.UI.Message.Revert.

Sat Sep 29 13:48:48 BST 2012  Eric Kow <kowey@darcs.net>
  * Style/Tidy Darcs.UI.Commands.Revert.

Sat Sep 29 14:26:44 BST 2012  Eric Kow <kowey@darcs.net>
  * Move (amend-)record messages to doc and Darcs.UI.Message.

Sat Sep 29 16:40:27 BST 2012  Eric Kow <kowey@darcs.net>
  * Move darcs add messages to doc and Darcs.UI.Message.

Sat Sep 29 16:53:14 BST 2012  Eric Kow <kowey@darcs.net>
  * Move obliterate/unpull/unrecord messages to doc and Darcs.UI.Message.

Sat Sep 29 17:58:12 BST 2012  Eric Kow <kowey@darcs.net>
  * Move push messages to doc and Darcs.UI.Message.
Attachments
msg16283 (view) Author: markstos Date: 2012-11-02.00:50:16
Sounds like a valuable project. Thanks for working on it, Eric!
msg16495 (view) Author: ganesh Date: 2012-12-28.22:08:46
Should this be screened or not? :-)

I don't have particularly strong opinions about where the help text should 
be. What are the pros and cons?
msg17789 (view) Author: bf Date: 2014-11-14.00:53:36
I am in favour of this change. Maintaining help texts inside the source
code is horrible mainly due to Haskell's poor support for multiline
strings. Disclaimer: I haven't looked closely at the changes. I think it
is sad we did not screen this immediately. Eric, could you be bothered
to re-base them again (sorry!) in case the others agree?
msg17804 (view) Author: kowey Date: 2014-11-15.19:37:29
Hi Ben,

I'm afraid I'm still having trouble getting time back to work on this for
now.
But I have the hope of possibly making time for Darcs next year.

I'd be happy for anybody else to have a look, or make this be the thing I
start with.

Cheers,

Eric

On Fri Nov 14 2014 at 12:53:52 AM Ben Franksen <bugs@darcs.net> wrote:

>
> Ben Franksen <benjamin.franksen@helmholtz-berlin.de> added the comment:
>
> I am in favour of this change. Maintaining help texts inside the source
> code is horrible mainly due to Haskell's poor support for multiline
> strings. Disclaimer: I haven't looked closely at the changes. I think it
> is sad we did not screen this immediately. Eric, could you be bothered
> to re-base them again (sorry!) in case the others agree?
>
> __________________________________
> Darcs bug tracker <bugs@darcs.net>
> <http://bugs.darcs.net/patch953>
> __________________________________
> _______________________________________________
> darcs-devel mailing list
> darcs-devel@darcs.net
> http://lists.osuosl.org/mailman/listinfo/darcs-devel
>
Attachments
msg17995 (view) Author: bf Date: 2015-02-03.23:18:58
I am in the process of rebasing these changes to the HEAD.

Eric, the file src/Darcs/UI/Message/Unrecord.hs is missing, I guess you
forgot to add it. Could you send the missing file, please?
History
Date User Action Args
2012-09-29 17:01:16koweycreate
2012-11-02 00:50:16markstossetmessages: + msg16283
2012-12-28 22:08:46ganeshsetmessages: + msg16495
2012-12-28 22:09:01ganeshsetstatus: needs-screening -> in-discussion
2014-11-14 00:53:36bfsetmessages: + msg17789
2014-11-15 19:37:30koweysetfiles: + unnamed
messages: + msg17804
2015-02-03 23:18:58bfsetmessages: + msg17995
2015-02-05 15:43:37bfsetstatus: in-discussion -> followup-requested
assignedto: bf
nosy: + bf