I've burnt out for tonight, so here's a status update before I go to
bed. I'm working on:
- Convert command documentation from literate comments (visible in
user manual) to into cmd_help (visible in "darcs foo --help").
I wrote:
> I hope to have a coherent bundle ready for Eric sometime this weekend.
There's more work than I thought this morning, so there's a good chance
(perhaps two in three) that I won't have the base translation done by
Monday morning. If that happens I probably won't be able to grind on
this until next weekend.
$ darcs cha --last=100 --match 'author Trent && ( date 2008-11-09 || date
2008-11-08 )' -s --reverse
Sat Nov 8 15:24:37 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Teach make to render reST.
M ./GNUmakefile -30 +28
M ./autoconf.mk.in -10 +32
M ./configure.ac -39 +25
M ./doc/manual/darcs.txt -1 +5
Sat Nov 8 19:29:50 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Haddockize Lcs.
./src/Lcs.lhs -> ./src/Lcs.hs
M ./src/Lcs.hs -54 +40
Sat Nov 8 20:01:06 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Remove mangled TeX copy of the GPL2.
R ./doc/manual/gpl.txt
Sat Nov 8 20:01:56 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Whitespace cleanup.
I used Emacs' M-x whitespace cleanup RET command in this way:
find doc/manual/*.txt -exec emacs -Q -batch {} \
-f universal-argument -f whitespace-cleanup -f save-buffer \;
M ./doc/manual/best_practices.txt -22 +20
M ./doc/manual/building_darcs.txt -22 +21
M ./doc/manual/configuring_darcs.txt -12 +12
M ./doc/manual/darcs.txt -42 +42
M ./doc/manual/features.txt -1
M ./doc/manual/formats.txt -8 +7
M ./doc/manual/switching.txt -3 +2
Sat Nov 8 20:08:36 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Include patch count in user manual.
M ./GNUmakefile -2 +3
Sat Nov 8 20:15:00 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Add editor hints described in HACKING.txt.
M ./doc/manual/best_practices.txt +20
M ./doc/manual/building_darcs.txt +20
M ./doc/manual/configuring_darcs.txt +20
M ./doc/manual/darcs.txt +20
M ./doc/manual/features.txt +20
M ./doc/manual/formats.txt +20
M ./doc/manual/switching.txt +20
Sat Nov 8 20:39:01 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Refactor user manual's title.
It is useful to put "user manual" in the title, because it tells
readers and reminds authors who the document is for.
Removing the (now long) version from the title makes it less
overwhelming, and adding it to the metadata block makes it propagate
*as* metadata to the output formats (e.g. HTML "meta" tags, pdfinfo).
M ./doc/manual/darcs.txt -3 +4
Sat Nov 8 20:53:14 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Split "Getting Started" chapter from top-level document.
M ./doc/manual/darcs.txt -504
A ./doc/manual/getting-started.txt
Sat Nov 8 21:29:50 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Split "Introduction" chapter from top-level document.
M ./doc/manual/darcs.txt -137 +5
A ./doc/manual/introduction.txt
Sat Nov 8 21:47:16 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Help writers to find the right file to edit.
M ./GNUmakefile -3 +8
Sat Nov 8 21:48:09 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Don't render weird single-page "patch-theory" document.
The content probably ought to be folded into a separate paper on patch
theory, where the target audience is mathematicians rather than end
users (user manual) or developers (haddock).
M ./GNUmakefile -3 +1
Sat Nov 8 22:28:08 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Translate user manual content in Darcs.Repository.Motd to reST.
M ./src/Darcs/Repository/Motd.lhs -20 +21
Sat Nov 8 22:29:55 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Translate user manual content in Darcs.ArgumentDefaults to reST.
M ./src/Darcs/ArgumentDefaults.lhs -93 +92
Sat Nov 8 22:38:21 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Remove unnecessary single quotes.
M ./doc/manual/building_darcs.txt -1 +1
Sat Nov 8 22:41:04 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Translate user manual content in Darcs.Repository.Prefs to reST.
M ./src/Darcs/Repository/Prefs.lhs -115 +115
Sat Nov 8 22:51:42 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Support passing rst2foo args through make.
This allows the user to do stuff like this
make pdf RST2PDFFLAGS='-cb 1 -s serif.json'
make odt RST2ODTFLAGS=--add-syntax-highlighting
rather than having to edit the makefile itself.
M ./autoconf.mk.in -4 +4
Sat Nov 8 23:16:45 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Miscellaneous reST translation touch-ups.
M ./doc/manual/best_practices.txt -1 +1
M ./doc/manual/building_darcs.txt -2 +2
M ./doc/manual/configuring_darcs.txt -39 +26
Sat Nov 8 23:45:33 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Refactor layout of "Environment Variables" section.
In particular, use definition list markup for all the environment
variables. This hopefully obviates the (ugly) list of hyperlinks at
the top of the document -- except for DARCS_EMAIL, which is defined
elsewhere. To this end I have added a stub DARCS_EMAIL description.
Also fixed heading depth and use title case in headings.
M ./doc/manual/configuring_darcs.txt -120 +88
Sun Nov 9 00:12:58 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Translate user manual content in Darcs.Arguments to reST.
M ./doc/manual/configuring_darcs.txt +5
M ./src/Darcs/Arguments.lhs -233 +188
Sun Nov 9 00:15:23 EST 2008 Trent W. Buck <[EMAIL PROTECTED]>
* Split user manual source from unrelated Darcs.Commands source.
Translate to reST at the same time.
Removed stale reference to --overview and refactored surrounding text.
./src/Darcs/Commands.lhs -> ./src/Darcs/Commands.hs
A ./doc/manual/commands.txt
M ./doc/manual/darcs.txt -126 +1
M ./src/Darcs/Commands.hs -92 +16
_______________________________________________
darcs-users mailing list
[email protected]
http://lists.osuosl.org/mailman/listinfo/darcs-users
