[PATCH 0 of 6] reStructuredText help output

Martin Geisler mg at lazybytes.net
Sun Jul 19 06:23:19 CDT 2009


Christian Ebert <blacktrash at gmx.net> writes:

> * Martin Geisler on Friday, July 10, 2009 at 13:54:31 +0200
>> The idea is to format the docstrings in 'hg help' with a very simple
>> reStructuredText parser, and then use the full rst2html and rst2man
>> programs for building the HTML and man pages. There will thus be no
>> runtime dependency on Docutils -- it is only used for 'make doc'.
>
> Where is the best place to get rst2man?
>
> I've got docutils installed but rst2man is not part of it.

It is still part of their "sandbox", so you have to download it
separately. There is a link at the Docutils homepage:

  http://docutils.sourceforge.net/docutils-sandbox-snapshot.tgz

It's called manpage-writer inside the tarball. Alternatively you can use
my converted repo:

  http://bitbucket.org/mg/rst2man/

> Is rst2html the same as rst2html.py installed by docutils?

Yes -- it's installed as rst2html by Debian for instance (they package a
snapshot of rst2html), but as rst2html.py by the setup.py.

-- 
Martin Geisler

VIFF (Virtual Ideal Functionality Framework) brings easy and efficient
SMPC (Secure Multiparty Computation) to Python. See: http://viff.dk/.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 196 bytes
Desc: not available
Url : http://selenic.com/pipermail/mercurial-devel/attachments/20090719/72fda4c9/attachment.pgp 


More information about the Mercurial-devel mailing list