sapling/doc
Martin Geisler ab7c29bc29 doc: add newline after literal blocks in man pages
The rst2man writer leaves no space between a literal block and the
following paragraph. This patch corrects this.

It has also been applied upstream. This does not conflict with this
change since any number of newlines can be added without effecting the
rendered man page.
2009-07-16 23:25:26 +02:00
..
ja change wiki/bts URLs to point to new hostname 2009-06-24 15:32:37 +02:00
gendoc.py doc: use reStructuredText for man and HTML pages 2009-07-16 23:25:26 +02:00
hg.1.txt doc: use reStructuredText for man and HTML pages 2009-07-16 23:25:26 +02:00
hgignore.5.txt doc: use reStructuredText for man and HTML pages 2009-07-16 23:25:26 +02:00
hgrc.5.txt doc: use reStructuredText for man and HTML pages 2009-07-16 23:25:26 +02:00
Makefile doc: add newline after literal blocks in man pages 2009-07-16 23:25:26 +02:00
README Update asciidoc instructions to suggest html4 for newer versions 2007-08-01 14:32:05 -07:00

Mercurial's documentation is currently kept in ASCIIDOC format, which
is a simple plain text format that's easy to read and edit. It's also
convertible to a variety of other formats including standard UNIX man
page format and HTML.

To do this, you'll need to install ASCIIDOC:

 http://www.methods.co.nz/asciidoc/

To generate the man page:

 asciidoc -d manpage -b docbook hg.1.txt
 xmlto man hg.1.xml

To display:

 groff -mandoc -Tascii hg.1 | more

To create the html page (without stylesheets):

 asciidoc -b html4 hg.1.txt

(older asciidoc may want html instead of html4 above)