add dirstate debugging commands -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 add dirstate debugging commands As I've played with various different merges and more recently rawcommit, I've found the following patch to be very very helpful in figuring out whether the dirstate is being left in a consistent or inconsistent state with respect to the current manifest. I attempted to deduce the invariants that were assumed by the current code, and then check it in this code. I may or may not have captured the design intent in this check; if not, I'd be very happy to hear more clearly what was intended, so that I can write tests to that expectation. Anyway, here's the patch. Not sure if it's a good idea to commit it to the mainline, or just leave it as a debugging aid. I attempted to package it so that it doesn't interfere with normal usage. Michael Fetterman (tweaked by mpm: remove -d magic) manifest hash: 869f5b5f954dc0f46ba27322359e811d5e21d71c -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (GNU/Linux) iD8DBQFCvP77ywK+sNU5EO8RArmtAKCCVuI2slANzWZ26P5edtH/ixdwNwCfZLWl 5P+V+C92II3usO4YW2MULKY= =/Pv4 -----END PGP SIGNATURE-----

     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