Benoit Boissinot <benoit.boissinot@ens-lyon.org> [Wed, 10 Jun 2009 03:10:46 +0200] rev 8776
doc: correctly escape *
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 01:14:16 +0200] rev 8775
hg.1: highlight references to commands and man pages
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 01:09:21 +0200] rev 8774
hg.1: simplify synopsis
Now that arguments can be mixed with options we can simplify the
synopsis considerably. Also, highlighting the command name in bold
(instead of italics) seem to be the standard convention.
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 00:55:57 +0200] rev 8773
hgrc.5: spell check
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 00:46:30 +0200] rev 8772
man pages: add meta data
This removes the fixme's that were otherwise inserted.
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 00:13:08 +0200] rev 8771
man pages: updated copyright years
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 00:11:24 +0200] rev 8770
hgrc.5: use NOTE admonition paragraph
Martin Geisler <mg@lazybytes.net> [Wed, 10 Jun 2009 00:06:20 +0200] rev 8769
hgrc.5: reformatted to avoid big chunks of monospaced text
The man page used to have lines longer than 80 characters, even though
all lines in the hgrc.5.txt file were wrapped nicely. The problem
turned out to be that the indented paragraphs started literal blocks
instead of normal paragraphs. The literal blocks were of course not
wrapped when displayed by man.
In short, the asciidoc rules require lists to be formatted like this:
foo::
Some description of foo.
+
Another paragraph in the description of foo. It *must* start flush
left and the plus is necessary to indicate that this is a list item
continuation.
Lists with nested lists can be formatted correctly using something
called "open blocks". These blocks are used to group the list items
and are marked by a line above and below with two dashes. See the
asciidoc user guide for the gory details...