mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-11-25 19:03:49 +08:00
Code Issues Packages Projects Releases Wiki Activity
29052482d1
cpython/Doc/Makefile

365 lines
9.4 KiB
Makefile
Raw Normal View History

added lots of comments
1995-03-18 00:01:35 +08:00
# Makefile for Python documentation
# ---------------------------------
#
use macros more; added some more docs
1995-03-20 21:00:32 +08:00
# See also the README file.
#
Updated a comment and the release number.
1999-04-22 22:16:14 +08: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-12 02:25:46 +08:00
# api -- Python/C API Reference Manual
Updated a comment and the release number.
1999-04-22 22:16:14 +08: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-12 02:25:46 +08: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 23:42:12 +08: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-08 03:30:16 +08: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-12 02:25:46 +08:00
# tut -- Python Tutorial
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
# inst -- Installing Python Modules
# dist -- Distributing Python Modules
added lots of comments
1995-03-18 00:01:35 +08:00
#
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08: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-08 03:30:16 +08:00
# with the three-letter designations above as the directory names.
Removed LaTeX version of reference manual. Added ref/ref.ps.
1996-10-23 04:00:02 +08:00
#
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08: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-18 00:01:35 +08: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-08 03:30:16 +08: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-29 05:05:16 +08: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-23 04:47:26 +08: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-18 00:01:35 +08: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-12 02:25:46 +08: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-18 00:01:35 +08: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 23:42:12 +08:00
#
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08: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-29 05:05:16 +08: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 23:42:12 +08:00
#
Added ref/ref.tex to REFFILES. Fixed up some comments. Removed info-related targets from the really big combined targets.
1998-07-29 05:05:16 +08: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-12 02:25:46 +08: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 23:42:12 +08:00
# the html/ directory. If you want to fix the GNU info process, look
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-13 01:08:37 +08:00
# in the info/ directory; please send patches to python-docs@python.org.
use macros more; added some more docs
1995-03-20 21:00:32 +08:00
Add a comment noting that the dependency information is stored in Makefile.deps.
2000-08-30 00:30:21 +08: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-23 04:47:26 +08:00
# Customization -- you *may* have to edit this
use macros more; added some more docs
1995-03-20 21:00:32 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08: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-08 03:30:16 +08: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-13 01:08:37 +08:00
# Ideally, you shouldn't need to edit beyond this point
added lots of comments
1995-03-18 00:01:35 +08: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-13 01:08:37 +08:00
HTMLDIR= html
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 23:43:08 +08: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-13 01:08:37 +08:00
TOOLSDIR= tools
> * Makefile: always create .ps files; add qua to 'all' target; > added 'clobber' target
1992-07-07 17:06:34 +08:00
Added comment clarifying that RELEASE is the documentation release number, not the Python release. Removed VERSION since it is not used.
1999-07-13 00:52:50 +08:00
# This is the *documentation* release, and is used to construct the file
# names of the downloadable tarballs.
Update the release number and date.
2000-10-13 23:35:27 +08:00
RELEASE=2.0
Added comment clarifying that RELEASE is the documentation release number, not the Python release. Removed VERSION since it is not used.
1999-07-13 00:52:50 +08:00
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-14 00:33:09 +08: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-13 01:08:37 +08:00
# These must be declared phony since there
# are directories with matching names:
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
.PHONY: api doc ext lib mac ref tut inst dist
Added support for the "Long HTML" version to the build/packaging process.
2000-04-08 00:27:15 +08:00
.PHONY: html info longhtml
More changes to support the new directory structure.
1998-05-07 09:39:06 +08:00
added lots of comments
1995-03-18 00:01:35 +08:00
# Main target
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
all: html
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-08 03:30:16 +08:00
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 23:42:12 +08:00
dvi:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) dvi)
Separate .dvi and .ps targets. More rational destination for texi2html.py.
1996-08-10 05:46:05 +08:00
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 23:42:12 +08:00
pdf:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) pdf)
Revised Makefile to handle the new directories correctly.
1998-03-07 05:29:34 +08:00
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 23:42:12 +08:00
ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) ps)
Much simpler version, intended as a script.
1992-03-06 18:56:42 +08:00
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 23:42:12 +08:00
world: ps pdf html tarballs
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-12 02:25:46 +08:00
# Targets for each document:
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
api.ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) api.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-12 02:25:46 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
doc.ps:
Add support for "Documenting Python".
1999-03-17 00:11:27 +08:00
(cd paper-$(PAPER); $(MAKE) doc.ps)
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
ext.ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) ext.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-12 02:25:46 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
lib.ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) lib.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-12 02:25:46 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
mac.ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) mac.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-12 02:25:46 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
ref.ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) ref.ps)
Reflect file renamings for the Python Library Reference. Fix style dependencies for HOWTO documents.
1998-07-24 21:58:27 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
tut.ps:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) tut.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-12 02:25:46 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
inst.ps:
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
(cd paper-$(PAPER); $(MAKE) inst.ps)
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
dist.ps:
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
(cd paper-$(PAPER); $(MAKE) dist.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-12 02:25:46 +08: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-13 01:08:37 +08:00
api.dvi:
(cd paper-$(PAPER); $(MAKE) api.dvi)
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-12 02:25:46 +08:00
Add support for "Documenting Python".
1999-03-17 00:11:27 +08:00
doc.dvi:
(cd paper-$(PAPER); $(MAKE) doc.dvi)
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-13 01:08:37 +08:00
ext.dvi:
(cd paper-$(PAPER); $(MAKE) ext.dvi)
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-08 03:30:16 +08: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-13 01:08:37 +08:00
lib.dvi:
(cd paper-$(PAPER); $(MAKE) lib.dvi)
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-08 03:30:16 +08: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-13 01:08:37 +08:00
mac.dvi:
(cd paper-$(PAPER); $(MAKE) mac.dvi)
ref.dvi:
(cd paper-$(PAPER); $(MAKE) ref.dvi)
tut.dvi:
(cd paper-$(PAPER); $(MAKE) tut.dvi)
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
inst.dvi:
(cd paper-$(PAPER); $(MAKE) inst.dvi)
dist.dvi:
(cd paper-$(PAPER); $(MAKE) dist.dvi)
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-13 01:08:37 +08:00
api.pdf:
(cd paper-$(PAPER); $(MAKE) api.pdf)
Add support for "Documenting Python".
1999-03-17 00:11:27 +08:00
doc.pdf:
(cd paper-$(PAPER); $(MAKE) doc.pdf)
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-13 01:08:37 +08:00
ext.pdf:
(cd paper-$(PAPER); $(MAKE) ext.pdf)
lib.pdf:
(cd paper-$(PAPER); $(MAKE) lib.pdf)
mac.pdf:
(cd paper-$(PAPER); $(MAKE) mac.pdf)
ref.pdf:
(cd paper-$(PAPER); $(MAKE) ref.pdf)
tut.pdf:
(cd paper-$(PAPER); $(MAKE) tut.pdf)
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-08 03:30:16 +08:00
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
inst.pdf:
(cd paper-$(PAPER); $(MAKE) inst.pdf)
dist.pdf:
(cd paper-$(PAPER); $(MAKE) dist.pdf)
added lots of comments
1995-03-18 00:01:35 +08:00
# The remaining part of the Makefile is concerned with various
use macros more; added some more docs
1995-03-20 21:00:32 +08:00
# conversions, as described above. See also the README file.
added lots of comments
1995-03-18 00:01:35 +08: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 23:43:08 +08:00
info:
(cd $(INFODIR); $(MAKE))
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-23 03:47:13 +08:00
use macros more; added some more docs
1995-03-20 21:00:32 +08: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-18 00:01:35 +08: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-12 05:03:01 +08:00
Added Greg Stein's docs for BaseHTTPServer.py. Moved docs for "re" to before docs for "regex".
1997-12-30 04:01:55 +08: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-29 03:20:43 +08: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-12 05:03:01 +08: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-13 01:08:37 +08: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-07 09:39:06 +08: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-13 01:08:37 +08:00
html:
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile)
(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-12 05:03:01 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
api htmlapi:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile api)
Merge alpha100 branch back to main trunk
1994-08-01 20:22:53 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
doc htmldoc:
Added htmldoc, to generate the HTML for "Documenting Python".
1999-03-19 03:08:47 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile doc)
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
ext htmlext:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile ext)
* Changed preface in texipre.dat. * Added libwww entry to Makefile. * Documented new array module. * Documented extensions to regex (last, substring, translation table).
1993-02-22 04:10:26 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
lib htmllib:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile lib)
First cut at welcoming the Python Reference Manual back to the fold.
1998-05-07 03:51:39 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
mac htmlmac:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile mac)
Add support for the Macintosh Library Modules document.
1998-05-16 01:02:10 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
ref htmlref:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile ref)
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
tut htmltut:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile tut)
added lots of comments
1995-03-18 00:01:35 +08:00
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
inst htmlinst:
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile inst)
Change the main targets to generate HTML instead of PostScript. Update the comments at the beginning of the file.
2001-01-23 04:47:26 +08:00
dist htmldist:
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-29 00:53:36 +08:00
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile dist)
Added support for the "Long HTML" version to the build/packaging process.
2000-04-08 00:27:15 +08:00
longhtml:
(cd longhtml; $(MAKE) PAPER=$(PAPER))
Revised Makefile to handle the new directories correctly.
1998-03-07 05:29:34 +08:00
# webchecker needs an extra flag to process the huge index from the libref
webcheck:
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) -f ../html/Makefile webcheck)
# 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-16 05:43:21 +08:00
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 23:49:45 +08:00
info-$(RELEASE).tgz: info
Added the info tarball to the tarballs target. Added the README to the info tarball.
1999-01-30 06:23:25 +08:00
(cd $(INFODIR); tar cf - README python.dir python-???.info*) \
| 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-20 00:01:04 +08: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-28 00:30:59 +08:00
info-$(RELEASE).tar.bz2: info
(cd $(INFODIR); tar cf - README python.dir python-???.info*) \
| bzip2 -9 >$@
Switch to .tgz instead of .tar.gz to appease Windows users. Clean up the clean & clobber targets.
1998-05-12 05:10:15 +08:00
latex-$(RELEASE).tgz:
Use the mksourcepgk script instead of mktarball.sh.
1999-08-03 04:20:14 +08:00
$(TOOLSDIR)/mksourcepkg --gzip $(RELEASE)
latex-$(VERSION).tar.gz, tarlatex: Create the source distribution. clean: Remove all the generatable tarballs.
1998-03-06 00:37:34 +08: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-28 00:30:59 +08:00
latex-$(RELEASE).tar.bz2:
Use the mksourcepgk script instead of mktarball.sh.
1999-08-03 04:20:14 +08:00
$(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-28 00:30:59 +08:00
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
latex-$(RELEASE).zip:
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
rm -f $@
Use the mksourcepgk script instead of mktarball.sh.
1999-08-03 04:20:14 +08:00
$(TOOLSDIR)/mksourcepkg --zip $(RELEASE)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
Fix two remaining references to all-pdf and all-ps to only use pdf and ps.
1998-07-29 11:49:44 +08:00
pdf-$(PAPER)-$(RELEASE).tgz: pdf
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-13 01:08:37 +08:00
(cd paper-$(PAPER); tar cf - *.pdf) | 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-13 06:33:50 +08: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-28 00:30:59 +08:00
pdf-$(PAPER)-$(RELEASE).tar.bz2: pdf
(cd paper-$(PAPER); tar cf - *.pdf) | bzip2 -9 >$@
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
pdf-$(PAPER)-$(RELEASE).zip: pdf
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
rm -f $@
(cd paper-$(PAPER); zip -q -9 ../$@ *.pdf)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08: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-28 00:30:59 +08:00
postscript-$(PAPER)-$(RELEASE).tar.bz2: ps
When building the tarball of the PostScript files, also generate & include a little README giving the page count of each file when printed.
1998-08-29 05:17:58 +08:00
(cd paper-$(PAPER); $(MAKE) README)
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
(cd paper-$(PAPER); tar cf - *.ps README) | bzip2 -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-13 06:33:50 +08: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-28 00:30:59 +08:00
postscript-$(PAPER)-$(RELEASE).tgz: ps
(cd paper-$(PAPER); $(MAKE) README)
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
(cd paper-$(PAPER); tar cf - *.ps README) | gzip -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-28 00:30:59 +08:00
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
postscript-$(PAPER)-$(RELEASE).zip: ps
(cd paper-$(PAPER); $(MAKE) README)
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
rm -f $@
(cd paper-$(PAPER); zip -q -9 ../$@ *.ps README)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
Fix the HTML tarball target to generate the HTML if needed instead of bombing.
1999-01-13 04:32:39 +08:00
html-$(RELEASE).tgz: html
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
(cd $(HTMLDIR); \
When building the HTML packages, make sure we pick up all the HTML files at the top level of the tree.
2000-09-09 05:54:44 +08:00
tar cf - *.html */*.css */*.html */*.gif) \
Pass the release number to the tools/mktarball.sh script. Nits.
1998-05-12 02:53:07 +08:00
| gzip -9 >$@
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-14 00:33:09 +08: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-28 00:30:59 +08:00
html-$(RELEASE).tar.bz2: html
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
(cd $(HTMLDIR); \
When building the HTML packages, make sure we pick up all the HTML files at the top level of the tree.
2000-09-09 05:54:44 +08:00
tar cf - *.html */*.css */*.html */*.gif) \
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-28 00:30:59 +08:00
| bzip2 -9 >$@
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
html-$(RELEASE).zip: html
Merged in changes from 1.5.2p2 release as appropriate.
2000-04-05 04:58:25 +08:00
rm -f $@
(cd $(HTMLDIR); \
When building the HTML packages, make sure we pick up all the HTML files at the top level of the tree.
2000-09-09 05:54:44 +08:00
zip -q -9 ../$@ *.html */*.css */*.html */*.gif)
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
Added support for the "Long HTML" version to the build/packaging process.
2000-04-08 00:27:15 +08:00
longhtml-$(RELEASE).zip: longhtml
rm -f $@
(cd longhtml; \
zip -q -9 ../$@ */*.css */*.html */*.gif)
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-20 00:01:04 +08: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-13 01:08:37 +08:00
tarhtml: html-$(RELEASE).tgz
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 23:49:45 +08: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-13 01:08:37 +08: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-20 00:01:04 +08:00
Use the mksourcepgk script instead of mktarball.sh.
1999-08-03 04:20:14 +08: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-26 04:49:09 +08:00
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
ziphtml: html-$(RELEASE).zip
Added support for the "Long HTML" version to the build/packaging process.
2000-04-08 00:27:15 +08:00
ziplonghtml: longhtml-$(RELEASE).zip
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08:00
zipps: postscript-$(PAPER)-$(RELEASE).zip
zippdf: pdf-$(PAPER)-$(RELEASE).zip
ziplatex: latex-$(RELEASE).zip
Do not build the "longhtml" version for pre-release versions.
2000-07-01 10:37:37 +08:00
# Only build the longhtml version for final releases; use the second
# version of this for pre-release versions.
#
#zips: zippdf zipps ziphtml ziplonghtml
zips: zippdf zipps ziphtml
Add zip archive support for html, pdf, ps, and latex archives. "zips" target produces all possible .zip files.
1999-07-24 00:11:36 +08: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-28 00:30:59 +08: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-03 04:20:14 +08: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-28 00:30:59 +08:00
Remove the bzip2 archives from the "distfiles" target. There are not enough downloads to keep this around.
2000-10-19 21:25:15 +08:00
distfiles: tarballs zips
$(TOOLSDIR)/mksourcepkg --zip --gzip $(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-28 00:30:59 +08:00
added lots of comments
1995-03-18 00:01:35 +08: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-16 05:43:21 +08: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-04 06:02:19 +08: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-13 06:33:50 +08:00
# - useful results: .dvi, .pdf, .ps, .texi, .info
Revised Makefile to handle the new directories correctly.
1998-03-07 05:29:34 +08:00
clean:
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) clean)
Added support for the "Long HTML" version to the build/packaging process.
2000-04-08 00:27:15 +08:00
(cd longhtml; $(MAKE) clean)
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) clean)
Switch to .tgz instead of .tar.gz to appease Windows users. Clean up the clean & clobber targets.
1998-05-12 05:10:15 +08:00
(cd $(INFODIR); $(MAKE) clean)
> * Makefile: always create .ps files; add qua to 'all' target; > added 'clobber' target
1992-07-07 17:06:34 +08:00
Simplify LaTeX2HTML targets && support re-use of output directories (which saves re-generation of images). Add l2hclean target.
1997-08-23 02:18:54 +08:00
l2hclean:
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 23:49:45 +08:00
(cd $(HTMLDIR); $(MAKE) clean)
Simplify LaTeX2HTML targets && support re-use of output directories (which saves re-generation of images). Add l2hclean target.
1997-08-23 02:18:54 +08:00
added lots of comments
1995-03-18 00:01:35 +08:00
# Remove temporaries as well as final products
Remove the "lib-" prefix from the name of the info archive.
1999-01-08 23:49:45 +08:00
clobber:
(cd $(HTMLDIR); $(MAKE) clobber)
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-13 01:08:37 +08: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-24 00:11:36 +08:00
rm -f latex-$(RELEASE).tgz html-$(RELEASE).zip
rm -f pdf-$(RELEASE).zip postscript-$(RELEASE).zip
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-13 01:08:37 +08:00
(cd paper-$(PAPER); $(MAKE) clobber)
Added support for the "Long HTML" version to the build/packaging process.
2000-04-08 00:27:15 +08:00
(cd longhtml; $(MAKE) clobber)
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-13 01:08:37 +08:00
(cd $(HTMLDIR); $(MAKE) clobber)
Switch to .tgz instead of .tar.gz to appease Windows users. Clean up the clean & clobber targets.
1998-05-12 05:10:15 +08:00
(cd $(INFODIR); $(MAKE) clobber)
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-23 03:47:13 +08:00
realclean: clobber
distclean: clobber
Reference in New Issue Copy Permalink