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.

Doc/Makefile

@@ -19,7 +19,7 @@
 # four.  You can also do "make lib" (etc.) to process individual
 # documents.
 #
-# There's one local style file: myformat.sty.  This defines a number
+# There's one local style file: python.sty.  This defines a number
 # of macros that are similar in name and intent as macros in Texinfo
 # (e.g. \code{...} and \emph{...}), as well as a number of
 # environments for formatting function and data definitions, also in
@@ -125,7 +125,7 @@ tut-all:  tut.dvi tut.pdf tut.ps l2htut
 	$(PDFLATEX) $*
 
 # Dependencies
-COMMONTEX=myformat.sty copyright.tex boilerplate.tex
+COMMONTEX=python.sty manual.cls copyright.tex boilerplate.tex
 
 $(DVIFILES): fix_hack $(COMMONTEX)
 
@@ -245,7 +245,7 @@ lib.texi: python-lib.texi
 
 l2h: l2hapi l2hext l2hlib l2htut
 
-l2htut: tut.dvi myformat.perl
+l2htut: tut.dvi manual.perl python.perl
 	$(L2H) $(L2HARGS) tut.tex
 	(cd tut; ../node2label.pl *.html)
 	sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
@@ -253,7 +253,7 @@ l2htut: tut.dvi myformat.perl
 	mv tut/xxx tut/tut.html
 	ln -s tut.html tut/index.html || true
 
-l2hext: ext.dvi myformat.perl
+l2hext: ext.dvi manual.perl python.perl
 	$(L2H) $(L2HARGS) ext.tex
 	(cd ext; ../node2label.pl *.html)
 	sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
@@ -261,7 +261,7 @@ l2hext: ext.dvi myformat.perl
 	mv ext/xxx ext/ext.html
 	ln -s ext.html ext/index.html || true
 
-l2hlib: lib.dvi myformat.perl
+l2hlib: lib.dvi manual.perl python.perl
 	./fix_libaux.sed <lib.aux >lib1.aux
 	mv lib1.aux lib.aux
 	if [ -d lib ] ; then rm -f lib/*.html ; fi
@@ -272,7 +272,7 @@ l2hlib: lib.dvi myformat.perl
 	mv lib/xxx lib/lib.html
 	ln -s lib.html lib/index.html || true
 
-l2hapi: api.dvi myformat.perl
+l2hapi: api.dvi manual.perl python.perl
 	$(L2H) $(L2HARGS) api.tex
 	(cd api; ../node2label.pl *.html)
 	sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
@@ -310,7 +310,7 @@ tarballs:  tarpdf tarps tarhtml
 # Housekeeping targets
 
 # Remove temporary files; all except the following:
-# - sources: .tex, .bib, .sty
+# - sources: .tex, .bib, .sty, *.cls
 # - useful results: .dvi, .pdf, .ps, .texi, .info
 clean:	l2hclean
 	rm -f @* *~ *.aux *.idx *.ilg *.ind *.log *.toc *.blg *.bbl *.py[co]

Doc/api.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 \title{Python/C API Reference Manual}
 

Doc/api/api.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 \title{Python/C API Reference Manual}
 

Doc/ext.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 % XXX PM Modulator
 

Doc/ext/ext.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 % XXX PM Modulator
 

Doc/lib.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 % NOTE: this file controls which chapters/sections of the library
 % manual are actually printed.  It is easy to customize your manual

Doc/lib/lib.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 % NOTE: this file controls which chapters/sections of the library
 % manual are actually printed.  It is easy to customize your manual

Doc/manual.cls

+%
+% manual.cls for the Python documentation
+%
+
+\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\ProvidesClass{manual}
+             [1998/03/03 Python manual]
+
+% Change the options here to get a different set of basic options,  This
+% is where to add things like "a4paper" or "10pt".
+%
+\LoadClass[twoside,openright]{report}
+
+
+% Optional packages:
+%
+% If processing of these documents fails at your TeX installation,
+% these may be commented out (independently) to make things work.
+% These are both supplied with the current version of the teTeX
+% distribution.
+%
+% The "fancyhdr" package makes nicer page footers reasonable to
+% implement, and is used to put the chapter and section information in 
+% the footers.
+%
+% The "times" package makes the default font the PostScript Times
+% font, which makes for smaller PostScript and a font that more people 
+% like.
+%
+\RequirePackage{fancyhdr}\typeout{Using fancier footers than usual.}
+\RequirePackage{times}\typeout{Using times fonts instead of Computer Modern.}
+
+
+% Required package:
+%
+% This gives us all the Python-specific markup that we really want.
+% This should come last.  Do not change this.
+%
+\RequirePackage{python}

Doc/manual.perl

+# -*- perl -*-
+#
+# This implements the Python manual class.  All it really needs to do it
+# load the "python" style.  The style code is not moved into the class code
+# at this time, since we expect additional document class to be developed
+# for the Python documentation in the future.  Appropriate relocations will
+# be made at that time.
+
+package main;
+
+require "python.perl";
+
+1;				# sheesh....

Doc/perl/manual.perl

+# -*- perl -*-
+#
+# This implements the Python manual class.  All it really needs to do it
+# load the "python" style.  The style code is not moved into the class code
+# at this time, since we expect additional document class to be developed
+# for the Python documentation in the future.  Appropriate relocations will
+# be made at that time.
+
+package main;
+
+require "python.perl";
+
+1;				# sheesh....

Doc/texinputs/manual.cls

+%
+% manual.cls for the Python documentation
+%
+
+\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\ProvidesClass{manual}
+             [1998/03/03 Python manual]
+
+% Change the options here to get a different set of basic options,  This
+% is where to add things like "a4paper" or "10pt".
+%
+\LoadClass[twoside,openright]{report}
+
+
+% Optional packages:
+%
+% If processing of these documents fails at your TeX installation,
+% these may be commented out (independently) to make things work.
+% These are both supplied with the current version of the teTeX
+% distribution.
+%
+% The "fancyhdr" package makes nicer page footers reasonable to
+% implement, and is used to put the chapter and section information in 
+% the footers.
+%
+% The "times" package makes the default font the PostScript Times
+% font, which makes for smaller PostScript and a font that more people 
+% like.
+%
+\RequirePackage{fancyhdr}\typeout{Using fancier footers than usual.}
+\RequirePackage{times}\typeout{Using times fonts instead of Computer Modern.}
+
+
+% Required package:
+%
+% This gives us all the Python-specific markup that we really want.
+% This should come last.  Do not change this.
+%
+\RequirePackage{python}

Doc/tut.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 % Things to do:
 % Add a section on file I/O

Doc/tut/tut.tex

-\documentclass[twoside,openright]{report}
-\usepackage{myformat}
+\documentclass{manual}
 
 % Things to do:
 % Add a section on file I/O