Mercurial > public > mercurial-scm > hg-stable
comparison .hgignore @ 52048:2a875530a023
doc: generate separate commands/topics/extension pages
This change modifies gendoc.py and Makefile so that individual pages for
commands, help topics, and extensions can be generated. A new index page is
also generated with links to all these pages. This makes it easier to look up
and search the help text of a given command or topic, instead of having to
deal with the giant hg.1 "all-in-one" page.
Since the list of individual pages varies based on the source code, we generate
a dynamic Makefile that contains this list of files as individual targets.
This gives us fine-grained control over output files. However, it greatly
increases the time spent generating all help pages. It's recommended to run
make with -j to make use of multi-core archs.
Individual man pages are produced in doc/man, and HTML ones are in doc/html
author | Ludovic Chabant <ludovic@chabant.com> |
---|---|
date | Mon, 09 Oct 2023 22:14:24 -0700 |
parents | 59820ae507b1 |
children | f5091286b10c |
comparison
equal
deleted
inserted
replaced
52047:1f5974f8f730 | 52048:2a875530a023 |
---|---|
38 contrib/vagrant/.vagrant | 38 contrib/vagrant/.vagrant |
39 contrib/merge-lists/target/ | 39 contrib/merge-lists/target/ |
40 dist | 40 dist |
41 packages | 41 packages |
42 doc/common.txt | 42 doc/common.txt |
43 doc/commandlist.txt | |
44 doc/extensionlist.txt | |
45 doc/topiclist.txt | |
46 doc/*.mk | |
43 doc/*.[0-9] | 47 doc/*.[0-9] |
44 doc/*.[0-9].txt | 48 doc/*.[0-9].txt |
45 doc/*.[0-9].gendoc.txt | 49 doc/*.[0-9].gendoc.txt |
46 doc/*.[0-9].{x,ht}ml | 50 doc/*.[0-9].{x,ht}ml |
51 doc/build | |
52 doc/html | |
53 doc/man | |
47 MANIFEST | 54 MANIFEST |
48 MANIFEST.in | 55 MANIFEST.in |
49 patches | 56 patches |
50 mercurial/__modulepolicy__.py | 57 mercurial/__modulepolicy__.py |
51 mercurial/__version__.py | 58 mercurial/__version__.py |