traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
cpython/Doc/Makefile

716 lines
22 KiB
Makefile
Raw Normal View History

added lots of comments
1995-03-17 12:01:35 -04:00
# Makefile for Python documentation
# ---------------------------------
#
use macros more; added some more docs
1995-03-20 09:00:32 -04:00
# See also the README file.
#
Updated a comment and the release number.
1999-04-22 11:16:14 -03:00
# This is a bit of a mess. The documents are identified by short names:
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
# api -- Python/C API Reference Manual
Updated a comment and the release number.
1999-04-22 11:16:14 -03:00
# doc -- Documenting Python
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
# ext -- Extending and Embedding the Python Interpreter
# lib -- Library Reference Manual
Remove all-<format> targets in favor of just <format>. Fix some comments. For lib.pdf, run tools/toc2bkm.py to get "bookmarks" in acroread.
1998-07-24 12:42:12 -03:00
# mac -- Macintosh Library Modules
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
# ref -- Python Reference Manual
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
# tut -- Python Tutorial
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
# inst -- Installing Python Modules
# dist -- Distributing Python Modules
added lots of comments
1995-03-17 12:01:35 -04:00
#
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-22 16:47:26 -04:00
# The LaTeX sources for each of these documents are in subdirectories
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
# with the three-letter designations above as the directory names.
Removed LaTeX version of reference manual. Added ref/ref.ps.
1996-10-22 17:00:02 -03:00
#
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-22 16:47:26 -04:00
# The main target creates HTML for each of the documents. You can
# also do "make lib" (etc.) to create the HTML versions of individual
# documents.
added lots of comments
1995-03-17 12:01:35 -04:00
#
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
# The document classes and styles are in the texinputs/ directory.
# These define a number of macros that are similar in name and intent
# as macros in Texinfo (e.g. \code{...} and \emph{...}), as well as a
Added ref/ref.tex to REFFILES. Fixed up some comments. Removed info-related targets from the really big combined targets.
1998-07-28 18:05:16 -03:00
# number of environments for formatting function and data definitions.
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-22 16:47:26 -04:00
# Documentation for the macros is included in "Documenting Python"; see
# http://www.python.org/doc/current/doc/doc.html, or the sources for
# this document in the doc/ directory.
added lots of comments
1995-03-17 12:01:35 -04:00
#
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
# Everything is processed by LaTeX. See the file `README' for more
# information on the tools needed for processing.
added lots of comments
1995-03-17 12:01:35 -04:00
#
# There's a problem with generating the index which has been solved by
# a sed command applied to the index file. The shell script fix_hack
# does this (the Makefile takes care of calling it).
#
# Additional targets attempt to convert selected LaTeX sources to
# various other formats. These are generally site specific because
# the tools used are all but universal. These targets are:
Remove all-<format> targets in favor of just <format>. Fix some comments. For lib.pdf, run tools/toc2bkm.py to get "bookmarks" in acroread.
1998-07-24 12:42:12 -03:00
#
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-22 16:47:26 -04:00
# ps -- convert all documents from LaTeX to PostScript
# pdf -- convert all documents from LaTeX to the
Added ref/ref.tex to REFFILES. Fixed up some comments. Removed info-related targets from the really big combined targets.
1998-07-28 18:05:16 -03:00
# Portable Document Format
Remove all-<format> targets in favor of just <format>. Fix some comments. For lib.pdf, run tools/toc2bkm.py to get "bookmarks" in acroread.
1998-07-24 12:42:12 -03:00
#
Added ref/ref.tex to REFFILES. Fixed up some comments. Removed info-related targets from the really big combined targets.
1998-07-28 18:05:16 -03:00
# See the README file for more information on these targets.
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
#
# The formatted output is located in subdirectories. For PDF and
# PostScript, look in the paper-$(PAPER)/ directory. For HTML, look in
Remove all-<format> targets in favor of just <format>. Fix some comments. For lib.pdf, run tools/toc2bkm.py to get "bookmarks" in acroread.
1998-07-24 12:42:12 -03:00
# the html/ directory. If you want to fix the GNU info process, look
update the documentation contact address
2003-07-29 23:55:28 -03:00
# in the info/ directory; please send patches to docs@python.org.
use macros more; added some more docs
1995-03-20 09:00:32 -04:00
Add a comment noting that the dependency information is stored in Makefile.deps.
2000-08-29 13:30:21 -03:00
# This Makefile only includes information on how to perform builds; for
# dependency information, see Makefile.deps.
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-22 16:47:26 -04:00
# Customization -- you *may* have to edit this
use macros more; added some more docs
1995-03-20 09:00:32 -04:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-22 16:47:26 -04:00
# You could set this to a4:
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
PAPER=letter
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
# Ideally, you shouldn't need to edit beyond this point
added lots of comments
1995-03-17 12:01:35 -04:00
Fix a comment. Avoid extra level of recursion in the paper-*/ directories. Added the "info" target to use the subdir. Partparse, however, is broken again.
1998-05-08 12:43:08 -03:00
INFODIR= info
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
TOOLSDIR= tools
> * Makefile: always create .ps files; add qua to 'all' target; > added 'clobber' target
1992-07-07 06:06:34 -03:00
Added comment clarifying that RELEASE is the documentation release number, not the Python release. Removed VERSION since it is not used.
1999-07-12 13:52:50 -03:00
# This is the *documentation* release, and is used to construct the file
# names of the downloadable tarballs.
Update to the same version info used by the interpreter.
2003-07-30 15:43:28 -03:00
RELEASE=2.4a0
Added comment clarifying that RELEASE is the documentation release number, not the Python release. Removed VERSION since it is not used.
1999-07-12 13:52:50 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
PYTHON= python
DVIPS= dvips -N0 -t $(PAPER)
Fix the most recent change to the invocation of the mkhowto script so that it works for all targets. The issue here is that there are two different levels in the directory tree at which we execute mkhowto, so we can't define it just once using a relative path (at least not with the current implementation and Makefile structure). We use the GNUish $(shell) function here to work around that restriction by identifying mkhowto using an absolute path.
2003-09-27 02:52:16 -03:00
# This is ugly! The issue here is that there are two different levels
# in the directory tree at which we execute mkhowto, so we can't
# define it just once using a relative path (at least not with the
# current implementation and Makefile structure). We use the GNUish
# $(shell) function here to work around that restriction by
Adjust the organization a bit and update some of the comments to better explain what's happening.
2003-09-27 04:37:09 -03:00
# identifying mkhowto and the commontex/ directory using absolute paths.
Fix the most recent change to the invocation of the mkhowto script so that it works for all targets. The issue here is that there are two different levels in the directory tree at which we execute mkhowto, so we can't define it just once using a relative path (at least not with the current implementation and Makefile structure). We use the GNUish $(shell) function here to work around that restriction by identifying mkhowto using an absolute path.
2003-09-27 02:52:16 -03:00
#
Adjust the organization a bit and update some of the comments to better explain what's happening.
2003-09-27 04:37:09 -03:00
PWD=$(shell pwd)
# (The trailing colon in the value is needed; TeX places it's default
# set of paths at the location of the empty string in the path list.)
TEXINPUTS=$(PWD)/commontex:
# The mkhowto script can be run from the checkout using the first
# version of this variable definition, or from a preferred version
# using the second version. The standard documentation is typically
# built using the second flavor, where the preferred version is from
# the Python CVS trunk.
#MKHOWTO= TEXINPUTS=$(TEXINPUTS) $(PYTHON) $(PWD)/tools/mkhowto
MKHOWTO= TEXINPUTS=$(TEXINPUTS) mkhowto
define a variable to specify the mkhowto program itself, as for any other application
2003-09-25 12:25:37 -03:00
MKDVI= $(MKHOWTO) --paper=$(PAPER) --dvi
MKHTML= $(MKHOWTO) --html --about html/stdabout.dat \
Sprinkle with --favicon options.
2002-10-30 13:07:02 -04:00
--iconserver ../icons --favicon ../icons/pyfav.gif \
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
--address $(PYTHONDOCS) --up-link ../index.html \
--up-title "Python Documentation Index" \
Always use --dvips-safe when generating HTML for the standard documentation since we do not have anything that causes dvips to be run except when PostScript is specifically requested, which is a separate target.
2001-10-30 12:28:46 -04:00
--global-module-index "../modindex.html" --dvips-safe
define a variable to specify the mkhowto program itself, as for any other application
2003-09-25 12:25:37 -03:00
MKISILOHTML=$(MKHOWTO) --html --about html/stdabout.dat \
Change the default path to icons so that "mkhowto" does the "right thing" by default when used for 3rd-party docs. This requires the standard Python docs to specify a location, but they are a bit of a special case in sharing one set of icons among several documents.
2002-10-01 12:20:20 -03:00
--iconserver ../icons \
Always use --dvips-safe when generating HTML for the standard documentation since we do not have anything that causes dvips to be run except when PostScript is specifically requested, which is a separate target.
2001-10-30 12:28:46 -04:00
--l2h-init perl/isilo.perl --numeric --split 1 \
--dvips-safe
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
MKISILO= iSilo386 -U -y -rCR -d0
define a variable to specify the mkhowto program itself, as for any other application
2003-09-25 12:25:37 -03:00
MKPDF= $(MKHOWTO) --paper=$(PAPER) --pdf
MKPS= $(MKHOWTO) --paper=$(PAPER) --ps
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
BUILDINDEX=$(TOOLSDIR)/buildindex.py
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
PYTHONDOCS="See <i><a href=\"about.html\">About this document...</a></i> for information on suggesting changes."
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
HTMLBASE= file:`pwd`
Integrated SF patch #539487 by Matthias Klose: This patch adds Milan Zamazal's conversion script and modifies the mkinfo script to build the info doc files from the LaTeX sources. Currently, the mac, doc and inst TeX files are not handled. Explicitly checks for GNU Emacs 21.
2002-05-03 01:50:51 -03:00
# The emacs binary used to build the info docs. GNU Emacs 21 is required.
EMACS= emacs
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
# The end of this should reflect the major/minor version numbers of
# the release:
there's a new "What's New" for Python 2.4
2003-07-30 16:14:54 -03:00
WHATSNEW=whatsnew24
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# what's what
MANDVIFILES= paper-$(PAPER)/api.dvi paper-$(PAPER)/ext.dvi \
paper-$(PAPER)/lib.dvi paper-$(PAPER)/mac.dvi \
paper-$(PAPER)/ref.dvi paper-$(PAPER)/tut.dvi
HOWTODVIFILES= paper-$(PAPER)/doc.dvi paper-$(PAPER)/inst.dvi \
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
paper-$(PAPER)/dist.dvi paper-$(PAPER)/$(WHATSNEW).dvi
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
MANPDFFILES= paper-$(PAPER)/api.pdf paper-$(PAPER)/ext.pdf \
paper-$(PAPER)/lib.pdf paper-$(PAPER)/mac.pdf \
paper-$(PAPER)/ref.pdf paper-$(PAPER)/tut.pdf
HOWTOPDFFILES= paper-$(PAPER)/doc.pdf paper-$(PAPER)/inst.pdf \
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
paper-$(PAPER)/dist.pdf paper-$(PAPER)/$(WHATSNEW).pdf
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
MANPSFILES= paper-$(PAPER)/api.ps paper-$(PAPER)/ext.ps \
paper-$(PAPER)/lib.ps paper-$(PAPER)/mac.ps \
paper-$(PAPER)/ref.ps paper-$(PAPER)/tut.ps
HOWTOPSFILES= paper-$(PAPER)/doc.ps paper-$(PAPER)/inst.ps \
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
paper-$(PAPER)/dist.ps paper-$(PAPER)/$(WHATSNEW).ps
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
DVIFILES= $(MANDVIFILES) $(HOWTODVIFILES)
PDFFILES= $(MANPDFFILES) $(HOWTOPDFFILES)
PSFILES= $(MANPSFILES) $(HOWTOPSFILES)
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
HTMLCSSFILES=html/api/api.css \
html/doc/doc.css \
html/ext/ext.css \
html/lib/lib.css \
html/mac/mac.css \
html/ref/ref.css \
html/tut/tut.css \
html/inst/inst.css \
html/dist/dist.css
ISILOCSSFILES=isilo/api/api.css \
isilo/doc/doc.css \
isilo/ext/ext.css \
isilo/lib/lib.css \
isilo/mac/mac.css \
isilo/ref/ref.css \
isilo/tut/tut.css \
isilo/inst/inst.css \
isilo/dist/dist.css
ALLCSSFILES=$(HTMLCSSFILES) $(ISILOCSSFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
INDEXFILES=html/api/api.html \
html/doc/doc.html \
html/ext/ext.html \
html/lib/lib.html \
html/mac/mac.html \
html/ref/ref.html \
html/tut/tut.html \
html/inst/inst.html \
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
html/dist/dist.html \
html/whatsnew/$(WHATSNEW).html
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
ALLHTMLFILES=$(INDEXFILES) html/index.html html/modindex.html html/acks.html
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
COMMONPERL= perl/manual.perl perl/python.perl perl/l2hinit.perl
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.
2001-10-29 13:40:40 -04:00
ANNOAPI=api/refcounts.dat tools/anno-api.py
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
include Makefile.deps
Added targets: tarps - one-sided PostScript tarps2 - two-sided PostScript, with ref.ps added as-is. tardvi - yes, some people want the .dvi files all-ps2 - Create the .ps files, but make sure the LaTeX openright option is used in the \documentclass.
1998-01-13 12:33:09 -04:00
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
# These must be declared phony since there
# are directories with matching names:
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
.PHONY: api doc ext lib mac ref tut inst dist
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
.PHONY: html info isilo
More changes to support the new directory structure.
1998-05-06 22:39:06 -03:00
added lots of comments
1995-03-17 12:01:35 -04:00
# Main target
Define the "all" target more reasonably, but retain "html" as the default target.
2002-05-25 17:28:46 -03:00
default: html
all: html dvi ps pdf isilo
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
dvi: $(DVIFILES)
pdf: $(PDFFILES)
ps: $(PSFILES)
Separate .dvi and .ps targets. More rational destination for texi2html.py.
1996-08-09 18:46:05 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
world: ps pdf html distfiles
Revised Makefile to handle the new directories correctly.
1998-03-06 17:29:34 -04:00
Much simpler version, intended as a script.
1992-03-06 06:56:42 -04:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Rules to build PostScript and PDF formats
.SUFFIXES: .dvi .ps
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
.dvi.ps:
$(DVIPS) -o $@ $<
Update some of the comments. Update the .tar.gz targets so that they work from the top level. Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 15:25:46 -03:00
Reflect file renamings for the Python Library Reference. Fix style dependencies for HOWTO documents.
1998-07-24 10:58:27 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Targets for each document:
# Python/C API Reference Manual
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.
2001-10-29 13:40:40 -04:00
paper-$(PAPER)/api.dvi: $(ANNOAPIFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) api.tex
Add support for "Documenting Python".
1999-03-16 12:11:27 -04:00
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.
2001-10-29 13:40:40 -04:00
paper-$(PAPER)/api.pdf: $(ANNOAPIFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) api.tex
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
Remove some unnecessary dependencies (minor).
2002-10-04 16:23:06 -03:00
paper-$(PAPER)/api.tex: api/api.tex
cp api/api.tex $@
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
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.
2001-10-29 13:40:40 -04:00
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
Remove some unnecessary dependencies (minor).
2002-10-04 16:23:06 -03:00
paper-$(PAPER)/intro.tex: api/intro.tex
cp api/intro.tex $@
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.
2001-10-29 13:40:40 -04:00
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
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Distributing Python Modules
paper-$(PAPER)/dist.dvi: $(DISTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../dist/dist.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/dist.pdf: $(DISTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../dist/dist.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Documenting Python
paper-$(PAPER)/doc.dvi: $(DOCFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../doc/doc.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/doc.pdf: $(DOCFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../doc/doc.tex
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Extending and Embedding the Python Interpreter
paper-$(PAPER)/ext.dvi: $(EXTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../ext/ext.tex
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/ext.pdf: $(EXTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../ext/ext.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Installing Python Modules
paper-$(PAPER)/inst.dvi: $(INSTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../inst/inst.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/inst.pdf: $(INSTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../inst/inst.tex
Add support for "Documenting Python".
1999-03-16 12:11:27 -04:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Python Library Reference
paper-$(PAPER)/lib.dvi: $(LIBFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../lib/lib.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/lib.pdf: $(LIBFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../lib/lib.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Macintosh Library Modules
paper-$(PAPER)/mac.dvi: $(MACFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../mac/mac.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/mac.pdf: $(MACFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../mac/mac.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Python Reference Manual
paper-$(PAPER)/ref.dvi: $(REFFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../ref/ref.tex
Cleaned out some more cruft. Added some new cruft. For some of the "big" targets, force things to happen in the "right" subdirectory, i.e., "make" will build the DVI and PostScript files in the paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript files in the paper-a4/ directory. Probably still needs some restructuring.
1998-05-07 16:30:16 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/ref.pdf: $(REFFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../ref/ref.tex
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
# Python Tutorial
paper-$(PAPER)/tut.dvi: $(TUTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKDVI) ../tut/tut.tex
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
paper-$(PAPER)/tut.pdf: $(TUTFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd paper-$(PAPER) && $(MKPDF) ../tut/tut.tex
added lots of comments
1995-03-17 12:01:35 -04:00
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
# What's New in Python X.Y
Add missing dependency information for the "What's New" document.
2002-11-26 18:13:41 -04:00
paper-$(PAPER)/$(WHATSNEW).dvi: whatsnew/$(WHATSNEW).tex
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
cd paper-$(PAPER) && $(MKDVI) ../whatsnew/$(WHATSNEW).tex
Add missing dependency information for the "What's New" document.
2002-11-26 18:13:41 -04:00
paper-$(PAPER)/$(WHATSNEW).pdf: whatsnew/$(WHATSNEW).tex
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
cd paper-$(PAPER) && $(MKPDF) ../whatsnew/$(WHATSNEW).tex
added lots of comments
1995-03-17 12:01:35 -04:00
# The remaining part of the Makefile is concerned with various
use macros more; added some more docs
1995-03-20 09:00:32 -04:00
# conversions, as described above. See also the README file.
added lots of comments
1995-03-17 12:01:35 -04:00
Fix a comment. Avoid extra level of recursion in the paper-*/ directories. Added the "info" target to use the subdir. Partparse, however, is broken again.
1998-05-08 12:43:08 -03:00
info:
Pass along the selected "What's New" document to the make file for the GNU info conversion.
2003-07-16 01:01:04 -03:00
cd $(INFODIR) && $(MAKE) EMACS=$(EMACS) WHATSNEW=$(WHATSNEW)
Changed way *.ind are forced to exist; the files are now reset to contain an empty index instead of touched. Note that for modindex.ind, this also includes "\label{modindex}" so that the modindex.py script doesn't change the set of labels in the document. Be more consistent in use of $* in commands.
1998-02-22 15:47:13 -04:00
use macros more; added some more docs
1995-03-20 09:00:32 -04:00
# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
# HTML converter. For more info on this program, see
added lots of comments
1995-03-17 12:01:35 -04:00
# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
(Makefile): Updated comments about using LaTeX2HTML for the library reference. Made the extension to the input files for makeindex explicit; if not made explicit a directory of the given base name can cause makeindex to blow up. Specifically, if there is a directory ./lib/ created by LaTeX2HTML, "makeindex lib" will fail, but "makeindex lib.idx" will not. l2h{tut,ext,lib} are now dependent on myformat.perl. l2h adds ls2lib and removes the non-existant l2href.
1996-11-11 17:03:01 -04:00
Added Greg Stein's docs for BaseHTTPServer.py. Moved docs for "re" to before docs for "regex".
1997-12-29 16:01:55 -04:00
# Note that LaTeX2HTML inserts references to an icons directory in
# each page that it generates. I have placed a copy of this directory
# in the distribution to simplify the process of creating a
# self-contained HTML distribution; for this purpose I have also added
# a (trivial) index.html. Change the definition of $ICONSERVER in
Move a bit closer to HTML generation without depending on the temp files being in the current directory. Be more careful cleaning up. Correct an error in a comment. Add recent additions to the dependencies for lib.dvi.
1998-04-28 16:20:43 -03:00
# perl/l2hinit.perl to use a different location for the icons directory.
(Makefile): Updated comments about using LaTeX2HTML for the library reference. Made the extension to the input files for makeindex explicit; if not made explicit a directory of the given base name can cause makeindex to blow up. Specifically, if there is a directory ./lib/ created by LaTeX2HTML, "makeindex lib" will fail, but "makeindex lib.idx" will not. l2h{tut,ext,lib} are now dependent on myformat.perl. l2h adds ls2lib and removes the non-existant l2href.
1996-11-11 17:03:01 -04:00
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
# If you have the standard LaTeX2HTML icons installed, the versions shipped
# with this documentation should be stored in a separate directory and used
# instead. The standard set does *not* include all the icons used in the
# Python documentation.
More changes to support the new directory structure.
1998-05-06 22:39:06 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
$(ALLCSSFILES): html/style.css
cp $< $@
Correct dependency information -- the Python docs load the "About this document" text from html/stdabout.dat, not html/about.dat.
2003-05-22 12:28:55 -03:00
$(INDEXFILES): $(COMMONPERL) html/stdabout.dat tools/node2label.pl
(Makefile): Updated comments about using LaTeX2HTML for the library reference. Made the extension to the input files for makeindex explicit; if not made explicit a directory of the given base name can cause makeindex to blow up. Specifically, if there is a directory ./lib/ created by LaTeX2HTML, "makeindex lib" will fail, but "makeindex lib.idx" will not. l2h{tut,ext,lib} are now dependent on myformat.perl. l2h adds ls2lib and removes the non-existant l2href.
1996-11-11 17:03:01 -04:00
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
html/acks.html: ACKS $(TOOLSDIR)/support.py $(TOOLSDIR)/mkackshtml
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
$(PYTHON) $(TOOLSDIR)/mkackshtml --address $(PYTHONDOCS) \
Sprinkle with --favicon options.
2002-10-30 13:07:02 -04:00
--favicon icons/pyfav.gif \
The ACKS file is in the current directory when converted to HTML; this was broken when converting to a flat Makefile. ;-(
2001-02-22 19:06:21 -04:00
--output html/acks.html <ACKS
Merge alpha100 branch back to main trunk
1994-08-01 09:22:53 -03:00
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
# html/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. The index
# files are not used to actually generate content.
update one more reference to a file that moved from texinputs/ to commontex/
2003-09-27 04:48:25 -03:00
BOILERPLATE=commontex/boilerplate.tex
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
html/index.html: $(INDEXFILES)
html/index.html: html/index.html.in $(BOILERPLATE) tools/rewrite.py
Add the "What's New" document to the index of HTML documents.
2002-03-26 16:29:11 -04:00
$(PYTHON) tools/rewrite.py $(BOILERPLATE) \
RELEASE=$(RELEASE) WHATSNEW=$(WHATSNEW) \
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
<$< >$@
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
html/modindex.html: $(TOOLSDIR)/support.py $(TOOLSDIR)/mkmodindex
html/modindex.html: html/lib/lib.html html/mac/mac.html
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd html && \
$(PYTHON) ../$(TOOLSDIR)/mkmodindex --columns 4 \
--output modindex.html --address $(PYTHONDOCS) \
Sprinkle with --favicon options.
2002-10-30 13:07:02 -04:00
--favicon icons/pyfav.gif \
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
lib/modindex.html mac/modindex.html
Added htmldoc, to generate the HTML for "Documenting Python".
1999-03-18 15:08:47 -04:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
html: $(ALLHTMLFILES) $(HTMLCSSFILES)
* Changed preface in texipre.dat. * Added libwww entry to Makefile. * Documented new array module. * Documented extensions to regex (last, substring, translation table).
1993-02-21 16:10:26 -04:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
api: html/api/api.html html/api/api.css
Added missing dependency on the refcount data file.
2002-05-23 16:41:25 -03:00
html/api/api.html: $(APIFILES) api/refcounts.dat
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/api api/api.tex
First cut at welcoming the Python Reference Manual back to the fold.
1998-05-06 16:51:39 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
doc: html/doc/doc.html html/doc/doc.css
html/doc/doc.html: $(DOCFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/doc doc/doc.tex
Add support for the Macintosh Library Modules document.
1998-05-15 14:02:10 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
ext: html/ext/ext.html html/ext/ext.css
html/ext/ext.html: $(EXTFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/ext ext/ext.tex
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
lib: html/lib/lib.html html/lib/lib.css
html/lib/lib.html: $(LIBFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/lib lib/lib.tex
added lots of comments
1995-03-17 12:01:35 -04:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
mac: html/mac/mac.html html/mac/mac.css
html/mac/mac.html: $(MACFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/mac mac/mac.tex
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
ref: html/ref/ref.html html/ref/ref.css
html/ref/ref.html: $(REFFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/ref ref/ref.tex
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 13:53:36 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
tut: html/tut/tut.html html/tut/tut.css
html/tut/tut.html: $(TUTFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(MKHTML) --dir html/tut --numeric --split 3 tut/tut.tex
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
inst: html/inst/inst.html html/inst/inst.css
html/inst/inst.html: $(INSTFILES) perl/distutils.perl
Use larger chunks for the HTML version of the Distutils documentation.
2001-03-01 14:38:56 -04:00
$(MKHTML) --dir html/inst --split 4 inst/inst.tex
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
dist: html/dist/dist.html html/dist/dist.css
html/dist/dist.html: $(DISTFILES) perl/distutils.perl
Use larger chunks for the HTML version of the Distutils documentation.
2001-03-01 14:38:56 -04:00
$(MKHTML) --dir html/dist --split 4 dist/dist.tex
Added support for the "Long HTML" version to the build/packaging process.
2000-04-07 13:27:15 -03:00
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
whatsnew: html/whatsnew/$(WHATSNEW).html
html/whatsnew/$(WHATSNEW).html: whatsnew/$(WHATSNEW).tex
$(MKHTML) --dir html/whatsnew --split 4 whatsnew/$(WHATSNEW).tex
Revised Makefile to handle the new directories correctly.
1998-03-06 17:29:34 -04:00
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
# The iSilo format is used by the iSilo document reader for PalmOS devices.
ISILOINDEXFILES=isilo/api/api.html \
isilo/doc/doc.html \
isilo/ext/ext.html \
isilo/lib/lib.html \
isilo/mac/mac.html \
isilo/ref/ref.html \
isilo/tut/tut.html \
isilo/inst/inst.html \
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
isilo/dist/dist.html \
isilo/whatsnew/$(WHATSNEW).html
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
Correct dependency information -- the Python docs load the "About this document" text from html/stdabout.dat, not html/about.dat.
2003-05-22 12:28:55 -03:00
$(ISILOINDEXFILES): $(COMMONPERL) html/stdabout.dat perl/isilo.perl
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo: isilo/python-api.pdb \
isilo/python-doc.pdb \
isilo/python-ext.pdb \
isilo/python-lib.pdb \
isilo/python-mac.pdb \
isilo/python-ref.pdb \
isilo/python-tut.pdb \
isilo/python-dist.pdb \
isilo/python-inst.pdb \
isilo/python-whatsnew.pdb
isilo/python-api.pdb: isilo/api/api.html isilo/api/api.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iPython/C API Reference Manual" \
isilo/api/api.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-doc.pdb: isilo/doc/doc.html isilo/doc/doc.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iDocumenting Python" \
isilo/doc/doc.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-ext.pdb: isilo/ext/ext.html isilo/ext/ext.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iExtending & Embedding Python" \
isilo/ext/ext.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-lib.pdb: isilo/lib/lib.html isilo/lib/lib.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iPython Library Reference" \
isilo/lib/lib.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-mac.pdb: isilo/mac/mac.html isilo/mac/mac.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iPython/C API Reference Manual" \
isilo/mac/mac.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-ref.pdb: isilo/ref/ref.html isilo/ref/ref.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iPython Reference Manual" \
isilo/ref/ref.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-tut.pdb: isilo/tut/tut.html isilo/tut/tut.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iPython Tutorial" \
isilo/tut/tut.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-dist.pdb: isilo/dist/dist.html isilo/dist/dist.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iDistributing Python Modules" \
isilo/dist/dist.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-inst.pdb: isilo/inst/inst.html isilo/inst/inst.css
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILO) "-iInstalling Python Modules" \
isilo/inst/inst.html $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
isilo/python-whatsnew.pdb: isilo/whatsnew/$(WHATSNEW).html isilo/whatsnew/$(WHATSNEW).css
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
$(MKISILO) "-iWhat's New in Python X.Y" \
isilo/whatsnew/$(WHATSNEW).html $@
Added missing dependency on the refcount data file.
2002-05-23 16:41:25 -03:00
isilo/api/api.html: $(APIFILES) api/refcounts.dat
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
$(MKISILOHTML) --dir isilo/api api/api.tex
isilo/doc/doc.html: $(DOCFILES)
$(MKISILOHTML) --dir isilo/doc doc/doc.tex
isilo/ext/ext.html: $(EXTFILES)
$(MKISILOHTML) --dir isilo/ext ext/ext.tex
isilo/lib/lib.html: $(LIBFILES)
$(MKISILOHTML) --dir isilo/lib lib/lib.tex
isilo/mac/mac.html: $(MACFILES)
$(MKISILOHTML) --dir isilo/mac mac/mac.tex
isilo/ref/ref.html: $(REFFILES)
$(MKISILOHTML) --dir isilo/ref ref/ref.tex
isilo/tut/tut.html: $(TUTFILES)
$(MKISILOHTML) --dir isilo/tut tut/tut.tex
isilo/inst/inst.html: $(INSTFILES) perl/distutils.perl
$(MKISILOHTML) --dir isilo/inst inst/inst.tex
isilo/dist/dist.html: $(DISTFILES) perl/distutils.perl
$(MKISILOHTML) --dir isilo/dist dist/dist.tex
Wire in the "What's New" document.
2002-03-26 15:18:18 -04:00
isilo/whatsnew/$(WHATSNEW).html: whatsnew/$(WHATSNEW).tex
$(MKISILOHTML) --dir isilo/whatsnew whatsnew/$(WHATSNEW).tex
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
# These are useful if you need to transport the iSilo-ready HTML to
# another machine to perform the conversion:
isilozip: isilo-html-$(RELEASE).zip
isilo-html-$(RELEASE).zip: $(ISILOINDEXFILES)
rm -f $@
cd isilo && \
zip -q -9 ../$@ */*.css */*.html */*.txt
Revised Makefile to handle the new directories correctly.
1998-03-06 17:29:34 -04:00
# webchecker needs an extra flag to process the huge index from the libref
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
WEBCHECKER=$(PYTHON) ../Tools/webchecker/webchecker.py
HTMLBASE= file:`pwd`/html
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
webcheck: $(ALLHTMLFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(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/
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
$(WEBCHECKER) $(HTMLBASE)/whatsnew/
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
fastwebcheck: $(ALLHTMLFILES)
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
$(WEBCHECKER) -x $(HTMLBASE)/api/
$(WEBCHECKER) -x $(HTMLBASE)/doc/
$(WEBCHECKER) -x $(HTMLBASE)/ext/
$(WEBCHECKER) -x -m290000 $(HTMLBASE)/lib/
$(WEBCHECKER) -x $(HTMLBASE)/mac/
$(WEBCHECKER) -x $(HTMLBASE)/ref/
$(WEBCHECKER) -x $(HTMLBASE)/tut/
$(WEBCHECKER) -x $(HTMLBASE)/dist/
$(WEBCHECKER) -x $(HTMLBASE)/inst/
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
$(WEBCHECKER) -x $(HTMLBASE)/whatsnew/
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
# Release packaging targets:
Made a start with api.tex, the Python-C API Reference Manual. Removed extref.tex (which provided the starting point). Also removed qua.tex, which is out of date and no longer needed.
1997-05-15 18:43:21 -03:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
paper-$(PAPER)/README: $(PSFILES) $(TOOLSDIR)/getpagecounts
Pass the -r option to getpagecounts to generate an entry for the "What's New" document.
2002-04-17 00:31:08 -03:00
cd paper-$(PAPER) && ../$(TOOLSDIR)/getpagecounts -r $(RELEASE) >../$@
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 11:49:45 -04:00
info-$(RELEASE).tgz: info
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd $(INFODIR) && tar cf - README python.dir python-*.info* \
- put the GNU info packages in the same place as everything else - add a convenience target to create the package list directly
2003-07-17 08:55:18 -03:00
| gzip -9 >../$@
Revised some targets to make better use of make "special" variables, to avoid repeating file names. Change lib.texi target to not overwrite the input file; work on a copy.
1998-02-19 12:01:04 -04:00
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
info-$(RELEASE).tar.bz2: info
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd $(INFODIR) && tar cf - README python.dir python-*.info* \
- put the GNU info packages in the same place as everything else - add a convenience target to create the package list directly
2003-07-17 08:55:18 -03:00
| bzip2 -9 >../$@
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
Switch to .tgz instead of .tar.gz to appease Windows users. Clean up the clean & clobber targets.
1998-05-11 18:10:15 -03:00
latex-$(RELEASE).tgz:
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
$(PYTHON) $(TOOLSDIR)/mksourcepkg --gzip $(RELEASE)
latex-$(VERSION).tar.gz, tarlatex: Create the source distribution. clean: Remove all the generatable tarballs.
1998-03-05 12:37:34 -04:00
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
latex-$(RELEASE).tar.bz2:
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
$(PYTHON) $(TOOLSDIR)/mksourcepkg --bzip2 $(RELEASE)
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
latex-$(RELEASE).zip:
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-04 17:58:25 -03:00
rm -f $@
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
$(PYTHON) $(TOOLSDIR)/mksourcepkg --zip $(RELEASE)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
pdf-$(PAPER)-$(RELEASE).tar: $(PDFFILES)
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
rm -f $@
mkdir Python-Docs-$(RELEASE)
cp paper-$(PAPER)/*.pdf Python-Docs-$(RELEASE)
tar cf $@ Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
pdf-$(PAPER)-$(RELEASE).tgz: pdf-$(PAPER)-$(RELEASE).tar
gzip -9 <$? >$@
Added tarpdf target. Don't remove *.texi & *.info for clean; only for clobber. Don't remake tarballs if not needed (PDF & PS only). HTML tarball is still painful.
1998-02-12 18:33:50 -04:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
pdf-$(PAPER)-$(RELEASE).tar.bz2: pdf-$(PAPER)-$(RELEASE).tar
bzip2 -9 <$? >$@
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
pdf-$(PAPER)-$(RELEASE).zip: pdf
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-04 17:58:25 -03:00
rm -f $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
mkdir Python-Docs-$(RELEASE)
cp paper-$(PAPER)/*.pdf Python-Docs-$(RELEASE)
zip -q -r -9 $@ Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
postscript-$(PAPER)-$(RELEASE).tar: $(PSFILES) paper-$(PAPER)/README
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
rm -f $@
mkdir Python-Docs-$(RELEASE)
cp paper-$(PAPER)/*.ps Python-Docs-$(RELEASE)
cp paper-$(PAPER)/README Python-Docs-$(RELEASE)
tar cf $@ Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
Added tarpdf target. Don't remove *.texi & *.info for clean; only for clobber. Don't remake tarballs if not needed (PDF & PS only). HTML tarball is still painful.
1998-02-12 18:33:50 -04:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
postscript-$(PAPER)-$(RELEASE).tar.bz2: postscript-$(PAPER)-$(RELEASE).tar
bzip2 -9 <$< >$@
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
postscript-$(PAPER)-$(RELEASE).tgz: postscript-$(PAPER)-$(RELEASE).tar
gzip -9 <$< >$@
postscript-$(PAPER)-$(RELEASE).zip: $(PSFILES) paper-$(PAPER)/README
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-04 17:58:25 -03:00
rm -f $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
mkdir Python-Docs-$(RELEASE)
cp paper-$(PAPER)/*.ps Python-Docs-$(RELEASE)
cp paper-$(PAPER)/README Python-Docs-$(RELEASE)
zip -q -r -9 $@ Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
HTMLPKGFILES=*.html */*.css */*.html */*.gif */*.txt
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
html-$(RELEASE).tar: $(ALLHTMLFILES) $(HTMLCSSFILES)
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
mkdir Python-Docs-$(RELEASE)
cd html && tar cf ../temp.tar $(HTMLPKGFILES)
cd Python-Docs-$(RELEASE) && tar xf ../temp.tar
rm temp.tar
tar cf html-$(RELEASE).tar Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
Added targets: tarps - one-sided PostScript tarps2 - two-sided PostScript, with ref.ps added as-is. tardvi - yes, some people want the .dvi files all-ps2 - Create the .ps files, but make sure the LaTeX openright option is used in the \documentclass.
1998-01-13 12:33:09 -04:00
Revise the rules for building the distribution files for the HTML format. These work again.
2001-07-17 20:35:46 -03:00
html-$(RELEASE).tgz: html-$(RELEASE).tar
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
gzip -9 <$? >$@
Revise the rules for building the distribution files for the HTML format. These work again.
2001-07-17 20:35:46 -03:00
html-$(RELEASE).tar.bz2: html-$(RELEASE).tar
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
bzip2 -9 <$? >$@
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
Update the rules so that changes to the HTML stylesheet cause appropriate work to be done, but do not require the HTML to be re-built.
2001-10-25 12:12:31 -03:00
html-$(RELEASE).zip: $(ALLHTMLFILES) $(HTMLCSSFILES)
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-04 17:58:25 -03:00
rm -f $@
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
mkdir Python-Docs-$(RELEASE)
cd html && tar cf ../temp.tar $(HTMLPKGFILES)
cd Python-Docs-$(RELEASE) && tar xf ../temp.tar
rm temp.tar
zip -q -r -9 $@ Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
isilo-$(RELEASE).zip: isilo
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
rm -f $@
mkdir Python-Docs-$(RELEASE)
cp isilo/python-*.pdb Python-Docs-$(RELEASE)
zip -q -r -9 $@ Python-Docs-$(RELEASE)
rm -r Python-Docs-$(RELEASE)
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
Revised some targets to make better use of make "special" variables, to avoid repeating file names. Change lib.texi target to not overwrite the input file; work on a copy.
1998-02-19 12:01:04 -04:00
# convenience targets:
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
tarhtml: html-$(RELEASE).tgz
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 11:49:45 -04:00
tarinfo: info-$(RELEASE).tgz
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
tarps: postscript-$(PAPER)-$(RELEASE).tgz
tarpdf: pdf-$(PAPER)-$(RELEASE).tgz
tarlatex: latex-$(RELEASE).tgz
Revised some targets to make better use of make "special" variables, to avoid repeating file names. Change lib.texi target to not overwrite the input file; work on a copy.
1998-02-19 12:01:04 -04:00
Use the mksourcepgk script instead of mktarball.sh.
1999-08-02 17:20:14 -03:00
tarballs: tarpdf tarps tarhtml
Added utility target tarhtml to tar and gzip the HTML files plus their support (GIFS, icons, style sheets).
1997-11-25 16:49:09 -04:00
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
ziphtml: html-$(RELEASE).zip
zipps: postscript-$(PAPER)-$(RELEASE).zip
zippdf: pdf-$(PAPER)-$(RELEASE).zip
ziplatex: latex-$(RELEASE).zip
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
zipisilo: isilo-$(RELEASE).zip
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
Do not build the "longhtml" version for pre-release versions.
2000-06-30 23:37:37 -03:00
zips: zippdf zipps ziphtml
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
bziphtml: html-$(RELEASE).tar.bz2
bzipinfo: info-$(RELEASE).tar.bz2
bzipps: postscript-$(PAPER)-$(RELEASE).tar.bz2
bzippdf: pdf-$(PAPER)-$(RELEASE).tar.bz2
bziplatex: latex-$(RELEASE).tar.bz2
Use the mksourcepgk script instead of mktarball.sh.
1999-08-02 17:20:14 -03:00
bzips: bzippdf bzipps bziphtml
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
Add convenience targets that build all archive types for single formatting versions.
2001-04-13 15:00:23 -03:00
disthtml: tarhtml bziphtml ziphtml
distinfo: tarinfo bzipinfo
distps: tarps bzipps zipps
distpdf: tarpdf bzippdf zippdf
distlatex: tarlatex bziplatex ziplatex
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
paperdist: distpdf distps
Include the GNU info format in the edist target since we're now building a fair portion of the documentation as info.
2003-07-17 12:29:16 -03:00
edist: disthtml distinfo zipisilo
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
- put the GNU info packages in the same place as everything else - add a convenience target to create the package list directly
2003-07-17 08:55:18 -03:00
pkglist:
$(TOOLSDIR)/mkpkglist >pkglist.html
Look to the future: bump the version number. Do more to ensure we don't do any more formatting than we need to. Use separate targets for the distribution packages for paper-based and non-paper-based formats; this avoids some extra packaging when a complete distribution is being built with both paper sizes.
2001-07-18 18:17:29 -03:00
distfiles: paperdist edist
Add bzip2 archives back to the set of generated archives; we had way too many reasonable requests to keep them around. Bump version number.
2001-01-25 13:32:51 -04:00
$(TOOLSDIR)/mksourcepkg --all $(RELEASE)
Update the package list whenever we build distfiles. This is used on www.python.org.
2003-04-23 12:04:52 -03:00
$(TOOLSDIR)/mkpkglist >pkglist.html
Add support for bzip2 compression. New target: distfiles, create all distribution archives, regardless of archive format. (Individual targets remain for each archive format.)
1999-07-27 13:30:59 -03:00
added lots of comments
1995-03-17 12:01:35 -04:00
# Housekeeping targets
Made a start with api.tex, the Python-C API Reference Manual. Removed extref.tex (which provided the starting point). Also removed qua.tex, which is out of date and no longer needed.
1997-05-15 18:43:21 -03:00
# Remove temporary files; all except the following:
Convert LaTeX support to create a new class of documents. HTML generation now requires LaTeX2HTML 98.1p1 or newer (& and is still in progress). This means that doing things to change the formatting of the manuals (at the "normal user" level, like A4 paper), can happen in just one place, rather than in each document file.
1998-03-03 18:02:19 -04:00
# - sources: .tex, .bib, .sty, *.cls
Added tarpdf target. Don't remove *.texi & *.info for clean; only for clobber. Don't remake tarballs if not needed (PDF & PS only). HTML tarball is still painful.
1998-02-12 18:33:50 -04:00
# - useful results: .dvi, .pdf, .ps, .texi, .info
Revised Makefile to handle the new directories correctly.
1998-03-06 17:29:34 -04:00
clean:
Revise the rules for building the distribution files for the HTML format. These work again.
2001-07-17 20:35:46 -03:00
rm -f html-$(RELEASE).tar
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd $(INFODIR) && $(MAKE) clean
> * Makefile: always create .ps files; add qua to 'all' target; > added 'clobber' target
1992-07-07 06:06:34 -03:00
added lots of comments
1995-03-17 12:01:35 -04:00
# Remove temporaries as well as final products
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 11:49:45 -04:00
clobber:
Revise the rules for building the distribution files for the HTML format. These work again.
2001-07-17 20:35:46 -03:00
rm -f html-$(RELEASE).tar
Massive cleanup: Use Makefiles in subdirs properly, move most of the detailed build rules to the subdirs. Allow pretty much every useful target to be built directly from the top dir (no change in output location).
1998-08-12 14:08:37 -03:00
rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz
rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-23 13:11:36 -03:00
rm -f latex-$(RELEASE).tgz html-$(RELEASE).zip
rm -f pdf-$(RELEASE).zip postscript-$(RELEASE).zip
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
rm -f $(DVIFILES) $(PSFILES) $(PDFFILES)
Bump the release number. Make the syntax of compound command lines more portable (nmake, CygWin). These changes are an adaptation of SF patch #429611. Use the new tools/rewrite.py instead of grep/date/sed to transform html/index.html.in into html/index.html; this is required for portability.
2001-07-17 13:53:19 -03:00
cd $(INFODIR) && $(MAKE) clobber
Update version number to match Include/patchlevel.h. Make sure we clean up all the temp files craeted for the typeset formats.
2002-02-04 15:49:29 -04:00
rm -f paper-$(PAPER)/*.tex paper-$(PAPER)/*.ind paper-$(PAPER)/*.idx
rm -f paper-$(PAPER)/*.l2h paper-$(PAPER)/*.how paper-$(PAPER)/README
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
rm -rf html/index.html html/modindex.html html/acks.html
rm -rf html/api/ html/doc/ html/ext/ html/lib/ html/mac/
rm -rf html/ref/ html/tut/ html/inst/ html/dist/
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
rm -rf html/whatsnew/
Additional rules to support the iSilo conversion.
2001-10-19 18:12:57 -03:00
rm -rf isilo/api/ isilo/doc/ isilo/ext/ isilo/lib/ isilo/mac/
rm -rf isilo/ref/ isilo/tut/ isilo/inst/ isilo/dist/
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 15:53:56 -04:00
rm -rf isilo/whatsnew/
Lots of changes to the packaging of the documentation, all to keep directories clean where the packages are unpacked. Each package now contains a single directory, Python-Docs-<version>/, which contains the files for that version of the documentation. Closes SF feature request #567576.
2002-08-09 17:20:50 -03:00
rm -f isilo/python-*.pdb isilo-$(RELEASE).zip
Convert to a "flat" Makefile.
2001-02-19 15:19:26 -04:00
realclean distclean: clobber