From f6ef297fe537de3712fce751bad8a597ef32e0ed Mon Sep 17 00:00:00 2001 From: Ben Kaduk Date: Tue, 11 Dec 2012 00:13:30 -0500 Subject: Make building docs easier in an unconfigured tree Instead of requiring the user to specify srcdir, top_srcdir, PYTHON, and possibly more in the future, make an 'htmlsrc' target that does so for them. This also lets us do the clean in the same step, so that only one command is required of the user. ticket: 7491 (new) tags: pullup target_version: 1.11 --- src/doc/Makefile.in | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'src') diff --git a/src/doc/Makefile.in b/src/doc/Makefile.in index 5f378bc85..1d977284a 100644 --- a/src/doc/Makefile.in +++ b/src/doc/Makefile.in @@ -36,13 +36,16 @@ LATEXOPTS= # Create HTML documentation in $(docsrc)/html suitable for a # release tarball or the web site (that is, without substitutions for # configured paths). This can be done in an unconfigured source tree -# with: -# make -f Makefile.in srcdir=. top_srcdir=.. PYTHON=python html -# make -f Makefile.in clean +# as: +# make -f Makefile.in htmlsrc html: composite rm -rf $(docsrc)/html $(SPHINX_BUILD) -q rst_composite $(docsrc)/html +# Dummy target for use in an unconfigured source tree. +htmlsrc: + $(MAKE) -f Makefile.in srcdir=. top_srcdir=.. PYTHON=python html clean + # Create HTML documentation in html_subst suitable for # installation by an OS package, with substitutions for configured # paths. -- cgit