comparison doc/Makefile @ 9418:a82db54bc3be

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.

9417:4c3fb45123e5

PREFIX=/usr/local
MANDIR=$(PREFIX)/share/man
INSTALL=install -c -m 644
PYTHON=python
RST2HTML=$(shell which rst2html 2> /dev/null || which rst2html.py)
RST2MAN=$(shell which rst2man 2> /dev/null || which rst2man.py)

all: man html

man: $(MAN)

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

%: %.txt common.txt
	$(RST2MAN) $*.txt > $*.tmp
# add newline after all literal blocks and fix backslash escape
	sed \
	  -e 's/^\.fi$$/.fi\n/' \
	  -e 's/\\fB\\\\fP/\\fB\\e\\fP/' \
	  $*.tmp > $*
	rm $*.tmp

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

MANIFEST: man html

9418:a82db54bc3be

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)

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