cpython

History

Fred Drake 3a7a3d745d "Driver" makefile to convert all documents to SGML or XML at once.		1999-01-14 18:13:59 +00:00
..
Makefile	"Driver" makefile to convert all documents to SGML or XML at once.	1999-01-14 18:13:59 +00:00
README	Add usage of the "driver" Makefile.	1999-01-14 18:12:33 +00:00
docfixer.py	Preliminary code to mark paragraphs. Seems to work, but very slow.	1999-01-06 22:50:52 +00:00
esis2sgml.py	Escape special characters on output.	1999-01-14 17:06:09 +00:00
esistools.py	Utility functions and misc. classes used in handling ESIS data.	1998-12-01 19:00:58 +00:00
fixgenents.sh	Handle SGML variant as well as XML variant. SGML is much more	1998-12-10 04:56:00 +00:00
latex2esis.py	Elaborate a comment on the format of the table that drives the	1999-01-14 18:10:09 +00:00
make.rules	Support conversions to both SGML and XML; SGML is the "default".	1998-12-01 19:05:56 +00:00

README

These scripts and Makefile fragment are used to convert the Python
documentation in LaTeX format to SGML.  XML is also supported as a
target, but is unlikely to be used.

This material is preliminary and incomplete.  The XML omnibus package
developed by the Python XML-SIG is required.  See
http://www.python.org/sigs/xml-sig/ for more information on the
package.

To convert all documents to SGML:

	cd Doc/
	make -f tools/sgmlconv/Makefile

To convert a document to SGML:

	cd Doc/<document-dir>
	make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools

To generate XML instead, use:

	cd Doc/<document-dir>
	make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools xml

Note that building the second target format is fast because both
conversions use the same intermediate format (an ESIS event stream).
This is true regardless of whether you build SGML or XML first.

Please send comments and bug reports to python-docs@python.org.