Add support for "Documenting Python".

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)
 

Doc/Makefile.deps

@@ -4,6 +4,8 @@
 
 APIFILES= ../api/api.tex
 
+DOCFILES= ../doc/doc.tex
+
 EXTFILES= ../ext/ext.tex
 
 TUTFILES= ../tut/tut.tex

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