cpython/Doc/tools/sgmlconv
Fred Drake 96c00b0b5e Define & use a Conversion object. It's still really ugly, but at
least there's a token object in here now!  ;-)
1999-05-07 19:59:02 +00:00
..
Makefile Use a common definition for $(SUBMAKE) instead of repeating everything 1999-02-15 16:50:28 +00:00
README Updated comments on version of XML package needed. 1999-01-29 22:35:23 +00:00
docfixer.py Add support for <platform>, some cleanup of module section after 1999-03-11 17:35:12 +00:00
esis2sgml.py Some adjustments, mostly to make it more general. 1999-02-18 16:30:16 +00:00
esistools.py Utility functions and misc. classes used in handling ESIS data. 1998-12-01 19:00:58 +00:00
fixgenents.sh Convert <version> to &version;. 1999-01-29 16:29:25 +00:00
latex2esis.py Define & use a Conversion object. It's still really ugly, but at 1999-05-07 19:59:02 +00:00
make.rules Minor adjustments to reflect esis2sgml.py changes. 1999-02-18 16:31:05 +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; specifically, the version
available in the public CVS repository.  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.