upstream/mercurial-mirror Files · doc/Makefile

doc: fixup font markup in man pages...

doc: fixup font markup in man pages This exposed a bug in rst2man where it neglects to escape a literal backslash. A patch has been applied upstream, but not yet packaged in, say, Debian unstable. A forward-compatible work-around has therefore been put in place.

Martin Geisler - - Load All Authors

File last commit:

r9161:e8b653a4 default


                r9161:e8b653a4

default

Download file

             Makefile
        
                    48 lines
            
             | 1.0 KiB
            
                | 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=rst2html

      RST2MAN=rst2man

      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

      	# add newline after all literal blocks and fix backslash escape

      	$(RST2MAN) $*.txt \

      	  | sed -e 's/^\.fi$$/.fi\n/' \

      	  | sed -e 's/\\fB\\\\fP/\\fB\\e\\fP/' \

      	  > $*

      %.html: %.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=rst2html
				RST2MAN=rst2man

				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
				# add newline after all literal blocks and fix backslash escape
				$(RST2MAN) $*.txt \
				\| sed -e 's/^\.fi$$/.fi\n/' \
				\| sed -e 's/\\fB\\\\fP/\\fB\\e\\fP/' \
				> $*

				%.html: %.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