From: Fred Drake <fdrake@acm.org>
Date: Sun, 28 Sep 2003 16:25:09 +0000 (+0000)
Subject: - update pkglist.html more frequently, and explain why that's helpful
X-Git-Tag: v2.3.2c1~7
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f7c35865c54d004535d510da972174589d3f52c2;p=thirdparty%2FPython%2Fcpython.git

- update pkglist.html more frequently, and explain why that's helpful
- add a comment explaining what pkglist.html is for
---

diff --git a/Doc/Makefile b/Doc/Makefile
index aaa9298a6a49..eee34963ec8d 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -672,9 +672,21 @@ distps:		tarps bzipps zipps
 distpdf:	tarpdf bzippdf zippdf
 distlatex:	tarlatex bziplatex ziplatex
 
-paperdist:	distpdf distps
-edist:		disthtml distinfo zipisilo
-
+# We use the "pkglist" target at the end of these to ensure the
+# package list is updated after building either of these; this seems a
+# reasonable compromise between only building it for distfiles or
+# having to build it manually.  Doing it here allows the packages for
+# distribution to be built using either of
+#     make distfiles && make PAPER=a4 paperdist
+#     make paperdist && make PAPER=a4 distfiles
+# The small amount of additional work is a small price to pay for not
+# having to remember which order to do it in. ;)
+paperdist:	distpdf distps pkglist
+edist:		disthtml distinfo zipisilo pkglist
+
+# The pkglist.html file is used as part of the download.html page on
+# python.org; it is not used as intermediate input here or as part of
+# the packages created.
 pkglist:
 	$(TOOLSDIR)/mkpkglist >pkglist.html