upstream/mercurial-mirror Files · doc/Makefile

generate hg manpage from commands.py docstring...

generate hg manpage from commands.py docstring gendoc.py is a script generating a part of the manpage (the commands help and options) from the docstring in commands.py. It avoids duplicating the doc between the doc/ directory and the docstrings. To generate the manpage, 'make doc' will create all the necessary intermediate files.

Benoit Boissinot - - Load All Authors

File last commit:

r1814:7956893e default


                r1814:7956893e

default

Download file

             Makefile
        
                    27 lines
            
             | 413 B
            
                | text/x-makefile
            
             |
                MakefileLexer
            
             / doc / Makefile
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      SOURCES=$(wildcard *.[0-9].txt)

      MAN=$(SOURCES:%.txt=%)

      HTML=$(SOURCES:%.txt=%.html)

      all: man html

      man: $(MAN)

      html: $(HTML)

      hg.1.txt: hg.1.gendoc.txt

      	touch hg.1.txt

      hg.1.gendoc.txt:

      	python gendoc.py > $@

      %: %.xml

      	xmlto man $*.xml

      %.xml: %.txt

      	asciidoc -d manpage -b docbook $*.txt

      %.html: %.txt

      	asciidoc -b html4 $*.txt || asciidoc -b html $*.txt

      clean:

      	$(RM) $(MAN) $(MAN:%=%.xml) $(MAN:%=%.html)

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				SOURCES=$(wildcard *.[0-9].txt)
				MAN=$(SOURCES:%.txt=%)
				HTML=$(SOURCES:%.txt=%.html)

				all: man html

				man: $(MAN)

				html: $(HTML)

				hg.1.txt: hg.1.gendoc.txt
				touch hg.1.txt

				hg.1.gendoc.txt:
				python gendoc.py > $@

				%: %.xml
				xmlto man $*.xml

				%.xml: %.txt
				asciidoc -d manpage -b docbook $*.txt

				%.html: %.txt
				asciidoc -b html4 $.txt \|\| asciidoc -b html $.txt

				clean:
				$(RM) $(MAN) $(MAN:%=%.xml) $(MAN:%=%.html)