annotate doc/README @ 3347:25d270e0b27f
ui.py: untangle updateopts
The code in ui.updateopts that handles ui.quiet, ui.verbose and
ui.debugflag is too smart, making it somewhat hard to see what
are the exact constraints placed on the values of these variables,
hiding some buglets.
This patch makes these constraints more explicit, fixing these
buglets and changing the behaviour slightly. It also adds a test
to make sure things work as expected in the future.
The buglets:
- setting ui.debug = True in a hgrc wouldn't turn on verbose mode
- additionally, setting ui.quiet = True or using --quiet would give
you a "quiet debug" mode.
The behaviour change:
- previously, in a hgrc file, ui.quiet wins against ui.verbose (i.e.
the final result would be quiet mode), but --verbose wins against
--quiet
- now ui.quiet nullifies ui.verbose and --verbose nullifies --quiet.
As a consequence, using -qv always gives you normal mode (unless
debug mode was turned on somewhere)
author |
Alexis S. L. Carvalho <alexis@cecm.usp.br> |
date |
Tue, 10 Oct 2006 18:43:20 -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
|