No longer needed since the main Makefile is "flat".
This commit is contained in:
Fred Drake
parent
f6bfe8e342
commit
842ab38d3d
@ -1,136 +0,0 @@
|
|||||||
# Convenience Makefile for building HTML documentation. You probably
|
|
||||||
# need to set TEXINPUTS from the command line for this to be useful,
|
|
||||||
# unless you actually build the .dvi files in the top level directory.
|
|
||||||
|
|
||||||
PAPER=letter
|
|
||||||
TOPDIR=..
|
|
||||||
TOOLSDIR=$(TOPDIR)/tools
|
|
||||||
PAPERDIR=$(TOPDIR)/paper-$(PAPER)
|
|
||||||
|
|
||||||
TEXINPUTS=$(TOPDIR)/paper-$(PAPER):$(TOPDIR)/texinputs:
|
|
||||||
|
|
||||||
# Where are the various programs?
|
|
||||||
PYTHON= python
|
|
||||||
WEBCHECKER=$(PYTHON) $(TOPDIR)/../Tools/webchecker/webchecker.py
|
|
||||||
MKHOWTO= $(TOOLSDIR)/mkhowto --about $(TOPDIR)/html/stdabout.dat \
|
|
||||||
--address $(PYTHONDOCS) --up-link ../index.html \
|
|
||||||
--up-title "Python Documentation Index" \
|
|
||||||
--global-module-index "../modindex.html"
|
|
||||||
MKHTML= $(MKHOWTO) --html
|
|
||||||
|
|
||||||
BUILDINDEX=$(TOOLSDIR)/buildindex.py
|
|
||||||
|
|
||||||
PYTHONDOCS='See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.'
|
|
||||||
HTMLBASE= file:`pwd`
|
|
||||||
|
|
||||||
INDEXFILES=api/api.html \
|
|
||||||
doc/doc.html \
|
|
||||||
ext/ext.html \
|
|
||||||
lib/lib.html \
|
|
||||||
mac/mac.html \
|
|
||||||
ref/ref.html \
|
|
||||||
tut/tut.html \
|
|
||||||
inst/inst.html \
|
|
||||||
dist/dist.html
|
|
||||||
|
|
||||||
COMMONPERL= $(TOPDIR)/perl/manual.perl \
|
|
||||||
$(TOPDIR)/perl/python.perl \
|
|
||||||
$(TOPDIR)/perl/l2hinit.perl
|
|
||||||
|
|
||||||
|
|
||||||
all: $(INDEXFILES) index.html modindex.html acks.html
|
|
||||||
|
|
||||||
.PHONY: api ext lib mac ref tut inst dist
|
|
||||||
|
|
||||||
api: api/api.html
|
|
||||||
doc: doc/doc.html
|
|
||||||
ext: ext/ext.html
|
|
||||||
lib: lib/lib.html
|
|
||||||
mac: mac/mac.html
|
|
||||||
ref: ref/ref.html
|
|
||||||
tut: tut/tut.html
|
|
||||||
inst: inst/inst.html
|
|
||||||
dist: dist/dist.html
|
|
||||||
|
|
||||||
$(INDEXFILES): $(COMMONPERL) \
|
|
||||||
$(TOPDIR)/html/about.dat \
|
|
||||||
$(TOPDIR)/tools/node2label.pl
|
|
||||||
|
|
||||||
include ../Makefile.deps
|
|
||||||
|
|
||||||
# The index.html target is at the end since it screws up font-lock.
|
|
||||||
|
|
||||||
acks.html: ../ACKS $(TOOLSDIR)/support.py $(TOOLSDIR)/mkackshtml
|
|
||||||
$(TOOLSDIR)/mkackshtml --address $(PYTHONDOCS) --output acks.html \
|
|
||||||
<../ACKS
|
|
||||||
|
|
||||||
modindex.html: $(TOOLSDIR)/support.py $(TOOLSDIR)/mkmodindex
|
|
||||||
modindex.html: lib/lib.html mac/mac.html
|
|
||||||
$(TOOLSDIR)/mkmodindex --columns 4 --output modindex.html \
|
|
||||||
--address $(PYTHONDOCS) \
|
|
||||||
lib/modindex.html mac/modindex.html
|
|
||||||
|
|
||||||
api/api.html: $(APIFILES) $(BUILDINDEX)
|
|
||||||
$(MKHTML) $(TOPDIR)/api/api.tex
|
|
||||||
|
|
||||||
doc/doc.html: $(DOCFILES) $(BUILDINDEX)
|
|
||||||
$(MKHTML) $(TOPDIR)/doc/doc.tex
|
|
||||||
|
|
||||||
ext/ext.html: $(EXTFILES)
|
|
||||||
$(MKHTML) $(TOPDIR)/ext/ext.tex
|
|
||||||
|
|
||||||
lib/lib.html: $(LIBFILES) $(BUILDINDEX)
|
|
||||||
$(MKHTML) $(TOPDIR)/lib/lib.tex
|
|
||||||
|
|
||||||
mac/mac.html: $(MACFILES) $(BUILDINDEX)
|
|
||||||
$(MKHTML) $(TOPDIR)/mac/mac.tex
|
|
||||||
|
|
||||||
ref/ref.html: $(REFFILES) $(BUILDINDEX)
|
|
||||||
$(MKHTML) $(TOPDIR)/ref/ref.tex
|
|
||||||
|
|
||||||
tut/tut.html: $(TUTFILES) $(TOOLSDIR)/mkhowto
|
|
||||||
$(MKHTML) --numeric --split 3 $(TOPDIR)/tut/tut.tex
|
|
||||||
|
|
||||||
inst/inst.html: $(INSTFILES) $(TOPDIR)/perl/distutils.perl
|
|
||||||
$(MKHTML) $(TOPDIR)/inst/inst.tex
|
|
||||||
|
|
||||||
dist/dist.html:$(DISTFILES) $(TOPDIR)/perl/distutils.perl
|
|
||||||
$(MKHTML) $(TOPDIR)/dist/dist.tex
|
|
||||||
|
|
||||||
webcheck: all
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/api/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/doc/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/ext/
|
|
||||||
$(WEBCHECKER) -m290000 $(HTMLBASE)/lib/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/mac/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/ref/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/tut/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/dist/
|
|
||||||
$(WEBCHECKER) $(HTMLBASE)/inst/
|
|
||||||
|
|
||||||
clean:
|
|
||||||
rm -rf @webchecker.pickle
|
|
||||||
|
|
||||||
distclean realclean clobber: clean
|
|
||||||
rm -rf index.html modindex.html acks.html
|
|
||||||
rm -rf api/ doc/ ext/ lib/ mac/ ref/ tut/ inst/ dist/
|
|
||||||
|
|
||||||
|
|
||||||
# This is really ugly, but we're not dependent on $(RELEASE), which isn't
|
|
||||||
# defined here. It also maintains the proper dependency on boilerplate.tex.
|
|
||||||
|
|
||||||
# index.html is dependent on $(INDEXFILES) since we want the date on
|
|
||||||
# the front index to be updated whenever any of the child documents
|
|
||||||
# are updated and boilerplate.tex uses \today as the date.
|
|
||||||
|
|
||||||
# It's at the end of the file since it wedges font-lock in XEmacs.
|
|
||||||
|
|
||||||
BOILERPLATE=$(TOPDIR)/texinputs/boilerplate.tex
|
|
||||||
index.html: $(TOPDIR)/html/index.html.in $(BOILERPLATE) $(INDEXFILES)
|
|
||||||
REL=`grep '\\release{' $(BOILERPLATE) | sed 's/.*\\release{\(.*\)}.*$$/\1/'`; \
|
|
||||||
REL=`echo "$$REL" | sed 's/[$$]//g'`; \
|
|
||||||
sed "s/@RELEASE@/$$REL/g" $< >TEMP
|
|
||||||
DATE=`grep '\\date{' $(BOILERPLATE) | sed 's/.*\\date{\(.*\)}.*$$/\1/'` ; \
|
|
||||||
if [ "$$DATE" = '\today' ] ; then DATE=`date '+%B %e, %Y'`;fi;\
|
|
||||||
sed "s/@DATE@/$$DATE/g" TEMP >$@
|
|
||||||
rm -f TEMP
|
|
||||||
@ -1,2 +0,0 @@
|
|||||||
include ../paper-letter/Makefile
|
|
||||||
PAPER=a4
|
|
||||||
@ -1,130 +0,0 @@
|
|||||||
# you could set this to a4
|
|
||||||
PAPER=letter
|
|
||||||
|
|
||||||
# Where are the various programs?
|
|
||||||
DVIPS= dvips -N0 -t $(PAPER)
|
|
||||||
PYTHON= python
|
|
||||||
|
|
||||||
TOOLSDIR= ../tools
|
|
||||||
|
|
||||||
MKHOWTO= $(TOOLSDIR)/mkhowto
|
|
||||||
MKDVI= $(MKHOWTO) --dvi
|
|
||||||
MKPDF= $(MKHOWTO) --pdf
|
|
||||||
|
|
||||||
|
|
||||||
# what's what
|
|
||||||
MANDVIFILES= api.dvi ext.dvi lib.dvi mac.dvi ref.dvi tut.dvi
|
|
||||||
HOWTODVIFILES= doc.dvi inst.dvi dist.dvi
|
|
||||||
|
|
||||||
MANPDFFILES= api.pdf ext.pdf lib.pdf mac.pdf ref.pdf tut.pdf
|
|
||||||
HOWTOPDFFILES= doc.pdf inst.pdf dist.pdf
|
|
||||||
|
|
||||||
MANPSFILES= api.ps ext.ps lib.ps mac.ps ref.ps tut.ps
|
|
||||||
HOWTOPSFILES= doc.ps inst.ps dist.ps
|
|
||||||
|
|
||||||
DVIFILES= $(MANDVIFILES) $(HOWTODVIFILES)
|
|
||||||
PDFFILES= $(MANPDFFILES) $(HOWTOPDFFILES)
|
|
||||||
PSFILES= $(MANPSFILES) $(HOWTOPSFILES)
|
|
||||||
|
|
||||||
|
|
||||||
include ../Makefile.deps
|
|
||||||
|
|
||||||
|
|
||||||
SCRIPTS: ../tools/indfix.py
|
|
||||||
|
|
||||||
$(DVIFILES): $(SCRIPTS) $(MKHOWTO)
|
|
||||||
$(PDFFILES): $(SCRIPTS) $(MKHOWTO)
|
|
||||||
|
|
||||||
|
|
||||||
# Rules to build PostScript and PDF formats
|
|
||||||
.SUFFIXES: .dvi .ps
|
|
||||||
|
|
||||||
.dvi.ps:
|
|
||||||
$(DVIPS) -o $@ $<
|
|
||||||
|
|
||||||
|
|
||||||
all: ps
|
|
||||||
dvi: $(DVIFILES)
|
|
||||||
pdf: $(PDFFILES)
|
|
||||||
ps: $(PSFILES)
|
|
||||||
|
|
||||||
|
|
||||||
README: $(PSFILES) $(TOOLSDIR)/getpagecounts
|
|
||||||
$(TOOLSDIR)/getpagecounts >$@
|
|
||||||
|
|
||||||
|
|
||||||
# Python/C API Reference Manual
|
|
||||||
api.dvi: api.tex $(APIFILES)
|
|
||||||
$(MKDVI) api.tex
|
|
||||||
|
|
||||||
api.pdf: api.tex $(APIFILES)
|
|
||||||
$(MKPDF) api.tex
|
|
||||||
|
|
||||||
api.tex: ../api/api.tex ../api/refcounts.dat ../tools/anno-api.py
|
|
||||||
$(PYTHON) ../tools/anno-api.py -o $@ ../api/api.tex
|
|
||||||
|
|
||||||
# Distributing Python Modules
|
|
||||||
dist.dvi: $(DISTFILES)
|
|
||||||
$(MKDVI) ../dist/dist.tex
|
|
||||||
|
|
||||||
dist.pdf: $(DISTFILES)
|
|
||||||
$(MKPDF) ../dist/dist.tex
|
|
||||||
|
|
||||||
# Documenting Python
|
|
||||||
doc.dvi: $(DOCFILES)
|
|
||||||
$(MKHOWTO) --dvi ../doc/doc.tex
|
|
||||||
|
|
||||||
doc.pdf: $(DOCFILES)
|
|
||||||
$(MKHOWTO) --pdf ../doc/doc.tex
|
|
||||||
|
|
||||||
# Extending and Embedding the Python Interpreter
|
|
||||||
ext.dvi: $(EXTFILES)
|
|
||||||
$(MKDVI) ../ext/ext.tex
|
|
||||||
|
|
||||||
ext.pdf: $(EXTFILES)
|
|
||||||
$(MKPDF) ../ext/ext.tex
|
|
||||||
|
|
||||||
# Installing Python Modules
|
|
||||||
inst.dvi: $(INSTFILES)
|
|
||||||
$(MKHOWTO) --dvi ../inst/inst.tex
|
|
||||||
|
|
||||||
inst.pdf: $(INSTFILES)
|
|
||||||
$(MKHOWTO) --pdf ../inst/inst.tex
|
|
||||||
|
|
||||||
# Python Library Reference
|
|
||||||
lib.dvi: $(LIBFILES)
|
|
||||||
$(MKDVI) ../lib/lib.tex
|
|
||||||
|
|
||||||
lib.pdf: $(LIBFILES)
|
|
||||||
$(MKPDF) ../lib/lib.tex
|
|
||||||
|
|
||||||
# Macintosh Library Modules
|
|
||||||
mac.dvi: $(MACFILES)
|
|
||||||
$(MKHOWTO) --dvi ../mac/mac.tex
|
|
||||||
|
|
||||||
mac.pdf: $(MACFILES)
|
|
||||||
$(MKHOWTO) --pdf ../mac/mac.tex
|
|
||||||
|
|
||||||
# Python Reference Manual
|
|
||||||
ref.dvi: $(REFFILES)
|
|
||||||
$(MKDVI) ../ref/ref.tex
|
|
||||||
|
|
||||||
ref.pdf: $(REFFILES)
|
|
||||||
$(MKPDF) ../ref/ref.tex
|
|
||||||
|
|
||||||
# Python Tutorial
|
|
||||||
tut.dvi: $(TUTFILES)
|
|
||||||
$(MKDVI) ../tut/tut.tex
|
|
||||||
|
|
||||||
tut.pdf: $(TUTFILES)
|
|
||||||
$(MKPDF) ../tut/tut.tex
|
|
||||||
|
|
||||||
|
|
||||||
clean:
|
|
||||||
rm -f *~ *.aux *.idx *.ilg *.ind *.log *.toc *.bkm *.syn *.pla api.tex
|
|
||||||
|
|
||||||
clobber: clean
|
|
||||||
rm -f $(DVIFILES) $(PSFILES) $(PDFFILES)
|
|
||||||
|
|
||||||
realclean: clobber
|
|
||||||
distclean: clobber
|
|
||||||
Loading…
x
Reference in New Issue
Block a user