Add support for "Documenting Python".

diff --git a/Doc/Makefile b/Doc/Makefile
index e48fdb24ee99c0a37d7282e1f60f2fb4cd554db9..7487f1506542c2d22aee0523730c5f0ae22b8afb 100644 (file)
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -84,6 +84,9 @@ world:        ps pdf html tarballs
 api api.ps:
        (cd paper-$(PAPER); $(MAKE) api.ps)
 
+doc doc.ps:
+       (cd paper-$(PAPER); $(MAKE) doc.ps)
+
 ext ext.ps:
        (cd paper-$(PAPER); $(MAKE) ext.ps)
 
@@ -103,6 +106,9 @@ tut tut.ps:
 api.dvi:
        (cd paper-$(PAPER); $(MAKE) api.dvi)
 
+doc.dvi:
+       (cd paper-$(PAPER); $(MAKE) doc.dvi)
+
 ext.dvi:
        (cd paper-$(PAPER); $(MAKE) ext.dvi)
 
@@ -122,6 +128,9 @@ tut.dvi:
 api.pdf:
        (cd paper-$(PAPER); $(MAKE) api.pdf)
 
+doc.pdf:
+       (cd paper-$(PAPER); $(MAKE) doc.pdf)
+
 ext.pdf:
        (cd paper-$(PAPER); $(MAKE) ext.pdf)
 

diff --git a/Doc/Makefile.deps b/Doc/Makefile.deps
index 2cdd019236d70639da6ff21702eb99fb6ec1c0b9..06f696178791d7cf911fc4a923d1a68dde4886ad 100644 (file)
--- a/Doc/Makefile.deps
+++ b/Doc/Makefile.deps
@@ -4,6 +4,8 @@
 
 APIFILES= ../api/api.tex
 
+DOCFILES= ../doc/doc.tex
+
 EXTFILES= ../ext/ext.tex
 
 TUTFILES= ../tut/tut.tex

diff --git a/Doc/paper-letter/Makefile b/Doc/paper-letter/Makefile
index 85438c9698947c8a03a97c86cb959466387cdc0b..88049f10a422145250442d1421ef7a417edfb159 100644 (file)
--- a/Doc/paper-letter/Makefile
+++ b/Doc/paper-letter/Makefile
@@ -12,19 +12,21 @@ TOOLSDIR=   ../tools
 TEXINPUTS=     .:../texinputs:
 
 MKDVI=         TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh
+# The --keep option is needed to keep the intermediate files for generating
+# the HTML global module index.
 MKHOWTO=       $(TOOLSDIR)/mkhowto --keep
 MKPDF=         TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh --pdf
 
 
 # what's what
 MANDVIFILES=   api.dvi ext.dvi lib.dvi ref.dvi tut.dvi
-HOWTODVIFILES= mac.dvi
+HOWTODVIFILES= doc.dvi mac.dvi
 
 MANPDFFILES=   api.pdf ext.pdf lib.pdf ref.pdf tut.pdf
-HOWTOPDFFILES= mac.pdf
+HOWTOPDFFILES= doc.pdf mac.pdf
 
 MANPSFILES=    api.ps ext.ps lib.ps ref.ps tut.ps
-HOWTOPSFILES=  mac.ps
+HOWTOPSFILES=  doc.ps mac.ps
 
 DVIFILES=      $(MANDVIFILES) $(HOWTODVIFILES)
 PDFFILES=      $(MANPDFFILES) $(HOWTOPDFFILES)
@@ -104,6 +106,13 @@ api.dvi: $(APIFILES)
 api.pdf: $(APIFILES)
        $(MKPDF) api
 
+# Documenting Python
+doc.dvi: $(DOCFILES) ../texinputs/ltxmarkup.sty
+       $(MKHOWTO) --dvi ../doc/doc.tex
+
+doc.pdf: $(DOCCFILES) ../texinputs/ltxmarkup.sty
+       $(MKHOWTO) --pdf ../doc/doc.tex
+
 # Extending and Embedding the Python Interpreter
 ext.dvi: $(EXTFILES)
        $(MKDVI) ext