Ignore EPIPE in pipefilter This hides the following traceback (there's a race condition involved, so you may have to try a few times to hit it): $ hg sign --key key-that-does-not-exist Signing 2062:4bad92f4ea65 gpg: skipped "key-that-does-not-exist": secret key not available gpg: signing failed: secret key not available Exception in thread Thread-1: Traceback (most recent call last): File "threading.py", line 442, in __bootstrap self.run() File "threading.py", line 422, in run self.__target(*self.__args, **self.__kwargs) File "mercurial/util.py", line 24, in writer pin.close() IOError: [Errno 32] Broken pipe abort: Error while signing

     1

Mercurial's documentation is currently kept in ASCIIDOC format, which

     2

is a simple plain text format that's easy to read and edit. It's also

     3

convertible to a variety of other formats including standard UNIX man

     4

page format and HTML.

     5

     6

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

     7

     8

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

     9

    10

To generate the man page:

    11

    12

 asciidoc -d manpage -b docbook hg.1.txt

    13

 xmlto man hg.1.xml

    14

    15

To display:

    16

    17

 groff -mandoc -Tascii hg.1 | more

    18

    19

To create the html page (without stylesheets):

    20

    21

 asciidoc -b html hg.1.txt