upstream/mercurial-mirror Files · doc/Makefile

doc: use our own rst2man.py script (issue1746)...

doc: use our own rst2man.py script (issue1746) The rst2man tool has not yet been part of an official Docutils release, and it is not present in most distributions. This poses a problem for people who want to install Mercurial from source, or who want to create a Mercurial package for such a distribution -- how to specify the build-dependencies? By including the rst2man.py script with Mercurial people only need a normal Docutils installation in order to install Mercurial.

Martin Geisler - - Load All Authors

File last commit:

r9418:a82db54b default


                r9418:a82db54b

default

Download file

             Makefile
        
                    43 lines
            
             | 962 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)

      PREFIX=/usr/local

      MANDIR=$(PREFIX)/share/man

      INSTALL=install -c -m 644

      PYTHON=python

      RST2HTML=$(shell which rst2html 2> /dev/null || which rst2html.py)

      all: man html

      man: $(MAN)

      html: $(HTML)

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

      	touch hg.1.txt

      hg.1.gendoc.txt: gendoc.py ../mercurial/commands.py ../mercurial/help.py

      	${PYTHON} gendoc.py > $@

      %: %.txt common.txt

      	$(PYTHON) rst2man.py $*.txt > $*

      %.html: %.txt common.txt

      	$(RST2HTML) $*.txt > $*.html

      MANIFEST: man html

      # tracked files are already in the main MANIFEST

      	$(RM) $@

      	for i in $(MAN) $(HTML) hg.1.gendoc.txt; do \

      	  echo "doc/$$i" >> $@ ; \

      	done

      install: man

      	for i in $(MAN) ; do \

      	  subdir=`echo $$i | sed -n 's/^.*\.\([0-9]\)$$/man\1/p'` ; \

      	  mkdir -p $(DESTDIR)$(MANDIR)/$$subdir ; \

      	  $(INSTALL) $$i $(DESTDIR)$(MANDIR)/$$subdir ; \

      	done

      clean:

      	$(RM) $(MAN) $(MAN:%=%.html) *.[0-9].gendoc.txt MANIFEST

	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)
				PREFIX=/usr/local
				MANDIR=$(PREFIX)/share/man
				INSTALL=install -c -m 644
				PYTHON=python
				RST2HTML=$(shell which rst2html 2> /dev/null \|\| which rst2html.py)

				all: man html

				man: $(MAN)

				html: $(HTML)

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

				hg.1.gendoc.txt: gendoc.py ../mercurial/commands.py ../mercurial/help.py
				${PYTHON} gendoc.py > $@

				%: %.txt common.txt
				$(PYTHON) rst2man.py $.txt > $

				%.html: %.txt common.txt
				$(RST2HTML) $.txt > $.html

				MANIFEST: man html
				# tracked files are already in the main MANIFEST
				$(RM) $@
				for i in $(MAN) $(HTML) hg.1.gendoc.txt; do \
				echo "doc/$$i" >> $@ ; \
				done

				install: man
				for i in $(MAN) ; do \
				subdir=`echo $$i \| sed -n 's/^.*\.\([0-9]\)$$/man\1/p'` ; \
				mkdir -p $(DESTDIR)$(MANDIR)/$$subdir ; \
				$(INSTALL) $$i $(DESTDIR)$(MANDIR)/$$subdir ; \
				done

				clean:
				$(RM) $(MAN) $(MAN:%=%.html) *.[0-9].gendoc.txt MANIFEST