annotate doc/README @ 2734:07026da25ed8
hbisect.py: don't rely on __del__ to write the current state.
This is yet another page of the "Thou shalt not do too much inside
__del__ methods" book, in the "demandload and __del__ don't go well
together" chapter.
The bisect extension is broken in 0.9.1:
$ hg bisect init
$ hg bisect bad
Fatal Python error: Interpreter not initialized (version mismatch?)
Aborted
(yes, I tripled checked my instalation to make sure the problem is not
there)
It's been broken since revision fe1689273f84 moved the import of the
binascii module into a demandload.
(In details: the first time that "hg bisect bad" (or good) is called,
there are still no revisions saved in .hg/bisect/*, so bisect.__init__
doesn't call hg.bin on anything. So, when we reach __del__, the
binascii module still hasn't been imported and we get that "nice"
message above.)
author |
Alexis S. L. Carvalho <alexis@cecm.usp.br> |
date |
Fri, 28 Jul 2006 21:20:41 -0300 |
parents |
7a3a3952c431 |
children |
8db8e1100f3f |
rev |
line source |
453
|
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.
|
177
|
5
|
453
|
6 To do this, you'll need to install ASCIIDOC:
|
177
|
7
|
453
|
8 http://www.methods.co.nz/asciidoc/
|
177
|
9
|
453
|
10 To generate the man page:
|
177
|
11
|
453
|
12 asciidoc -d manpage -b docbook hg.1.txt
|
|
13 xmlto man hg.1.xml
|
177
|
14
|
453
|
15 To display:
|
177
|
16
|
453
|
17 groff -mandoc -Tascii hg.1 | more
|
177
|
18
|
453
|
19 To create the html page (without stylesheets):
|
177
|
20
|
453
|
21 asciidoc -b html hg.1.txt
|