comparison doc/README @ 453:7a3a3952c431

Clarify doc/README a bit -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Clarify doc/README a bit manifest hash: db94c24344b56655bea5123ff79db75c7fa2d44c -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (GNU/Linux) iD8DBQFCu2cHywK+sNU5EO8RAuh7AKCZu3ZyrLaCvwlUvc8yY49hNOr2FwCfeQ8w Rpnt3GiIZ5PN01SwFt0B5jE= =953M -----END PGP SIGNATURE-----
author mpm@selenic.com
date Thu, 23 Jun 2005 17:51:03 -0800
parents 089594a5bbde
children
comparison
equal deleted inserted replaced
452:a1e91c24dab5 453:7a3a3952c431
1 Files in this directory: 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.
2 5
3 README - this file 6 To do this, you'll need to install ASCIIDOC:
4 hg.1.txt - asciidoc source for the files
5 hg.1 - groff man page for hg
6 hg.1.html - man page in html format
7 7
8 How to generate the man page and html files 8 http://www.methods.co.nz/asciidoc/
9 9
10 For now we use asciidoc which is available at: 10 To generate the man page:
11 11
12 http://www.methods.co.nz/asciidoc/ 12 asciidoc -d manpage -b docbook hg.1.txt
13 xmlto man hg.1.xml
13 14
14 the file hg.1.txt is the input file, to generate the man page: 15 To display:
15 16
16 asciidoc.py -d manpage -b docbook hg.1.txt 17 groff -mandoc -Tascii hg.1 | more
17 xmlto man hg.1.xml
18 18
19 to display: 19 To create the html page (without stylesheets):
20 20
21 groff -mandoc -Tascii hg.1 | more 21 asciidoc -b html hg.1.txt
22
23 to create the html page (without stylesheets):
24
25 asciidoc.py -b html hg.1.txt