summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2003-09-27 07:37:09 (GMT)
committerFred Drake <fdrake@acm.org>2003-09-27 07:37:09 (GMT)
commit0d86ea71b507debdbeef75cbd05ff12fa244d5a7 (patch)
tree90d8665d988f129b1e0c138adc9abe7b1e19b6af /Doc
parent2bc9b2fa2cc198968f34bf47c809e5264545ad2d (diff)
downloadcpython-0d86ea71b507debdbeef75cbd05ff12fa244d5a7.zip
cpython-0d86ea71b507debdbeef75cbd05ff12fa244d5a7.tar.gz
cpython-0d86ea71b507debdbeef75cbd05ff12fa244d5a7.tar.bz2
Adjust the organization a bit and update some of the comments to
better explain what's happening.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Makefile23
1 files changed, 14 insertions, 9 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index 2ea8180..821ea8a 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -71,21 +71,26 @@ RELEASE=2.4a0
PYTHON= python
DVIPS= dvips -N0 -t $(PAPER)
-PWD=$(shell pwd)
-
-# (The trailing colon in the value is needed; TeX places it's default
-# set of paths at the location of the empty string in the path list.)
-#
-TEXINPUTS=$(PWD)/commontex:
-
# This is ugly! The issue here is that there are two different levels
# in the directory tree at which we execute mkhowto, so we can't
# define it just once using a relative path (at least not with the
# current implementation and Makefile structure). We use the GNUish
# $(shell) function here to work around that restriction by
-# identifying mkhowto using an absolute path.
+# identifying mkhowto and the commontex/ directory using absolute paths.
#
-MKHOWTO= TEXINPUTS=$(TEXINPUTS) $(PYTHON) $(PWD)/tools/mkhowto
+PWD=$(shell pwd)
+
+# (The trailing colon in the value is needed; TeX places it's default
+# set of paths at the location of the empty string in the path list.)
+TEXINPUTS=$(PWD)/commontex:
+
+# The mkhowto script can be run from the checkout using the first
+# version of this variable definition, or from a preferred version
+# using the second version. The standard documentation is typically
+# built using the second flavor, where the preferred version is from
+# the Python CVS trunk.
+#MKHOWTO= TEXINPUTS=$(TEXINPUTS) $(PYTHON) $(PWD)/tools/mkhowto
+MKHOWTO= TEXINPUTS=$(TEXINPUTS) mkhowto
MKDVI= $(MKHOWTO) --paper=$(PAPER) --dvi
MKHTML= $(MKHOWTO) --html --about html/stdabout.dat \