From 520b0093db7da3f9aea4fbfaf727594971e38d7e Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Mon, 29 Oct 2001 17:40:40 +0000
Subject: [PATCH] Make sure we generate versions of each file in the Python/C
 API manual with reference-count annotations; this is needed for the typeset
 forms of the manuals.

---
 Doc/Makefile      | 38 +++++++++++++++++++++++++++++++++++---
 Doc/Makefile.deps | 17 +++++++++++++++++
 2 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/Doc/Makefile b/Doc/Makefile
index 0f95b75903b..432aa9e9229 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -146,6 +146,8 @@ ALLHTMLFILES=$(INDEXFILES) html/index.html html/modindex.html html/acks.html
 
 COMMONPERL= perl/manual.perl perl/python.perl perl/l2hinit.perl
 
+ANNOAPI=api/refcounts.dat tools/anno-api.py
+
 include Makefile.deps
 
 # These must be declared phony since there
@@ -173,15 +175,45 @@ world:	ps pdf html distfiles
 
 # Targets for each document:
 # Python/C API Reference Manual
-paper-$(PAPER)/api.dvi: paper-$(PAPER)/api.tex $(APIFILES)
+paper-$(PAPER)/api.dvi: $(ANNOAPIFILES)
 	cd paper-$(PAPER) && $(MKDVI) api.tex
 
-paper-$(PAPER)/api.pdf: paper-$(PAPER)/api.tex $(APIFILES)
+paper-$(PAPER)/api.pdf: $(ANNOAPIFILES)
 	cd paper-$(PAPER) && $(MKPDF) api.tex
 
-paper-$(PAPER)/api.tex: api/api.tex api/refcounts.dat tools/anno-api.py
+paper-$(PAPER)/api.tex: api/api.tex $(ANNOAPI)
 	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/api.tex
 
+paper-$(PAPER)/abstract.tex: api/abstract.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/abstract.tex
+
+paper-$(PAPER)/concrete.tex: api/concrete.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/concrete.tex
+
+paper-$(PAPER)/exceptions.tex: api/exceptions.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/exceptions.tex
+
+paper-$(PAPER)/init.tex: api/init.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/init.tex
+
+paper-$(PAPER)/intro.tex: api/intro.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/intro.tex
+
+paper-$(PAPER)/memory.tex: api/memory.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/memory.tex
+
+paper-$(PAPER)/newtypes.tex: api/newtypes.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/newtypes.tex
+
+paper-$(PAPER)/refcounting.tex: api/refcounting.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/refcounting.tex
+
+paper-$(PAPER)/utilities.tex: api/utilities.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/utilities.tex
+
+paper-$(PAPER)/veryhigh.tex: api/veryhigh.tex $(ANNOAPI)
+	$(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/veryhigh.tex
+
 # Distributing Python Modules
 paper-$(PAPER)/dist.dvi: $(DISTFILES)
 	cd paper-$(PAPER) && $(MKDVI) ../dist/dist.tex
diff --git a/Doc/Makefile.deps b/Doc/Makefile.deps
index 9718cffd64d..6f13673de78 100644
--- a/Doc/Makefile.deps
+++ b/Doc/Makefile.deps
@@ -31,6 +31,23 @@ APIFILES= $(MANSTYLES) $(INDEXSTYLES) $(COMMONTEX) \
 	api/veryhigh.tex \
 	texinputs/reportingbugs.tex
 
+# These files are generated from those listed above, and are used to
+# generate the typeset versions of the manuals.  The list is defined
+# here to make it easier to ensure parallelism.
+ANNOAPIFILES= $(MANSTYLES) $(INDEXSTYLES) $(COMMONTEX) \
+	paper-$(PAPER)/api.tex \
+	paper-$(PAPER)/abstract.tex \
+	paper-$(PAPER)/concrete.tex \
+	paper-$(PAPER)/exceptions.tex \
+	paper-$(PAPER)/init.tex \
+	paper-$(PAPER)/intro.tex \
+	paper-$(PAPER)/memory.tex \
+	paper-$(PAPER)/newtypes.tex \
+	paper-$(PAPER)/refcounting.tex \
+	paper-$(PAPER)/utilities.tex \
+	paper-$(PAPER)/veryhigh.tex \
+	texinputs/reportingbugs.tex
+
 DOCFILES= $(HOWTOSTYLES) \
 	texinputs/boilerplate.tex \
 	texinputs/ltxmarkup.sty \