cpython

mirror of https://github.com/python/cpython.git synced 2025-08-03 16:39:00 +00:00

History

Fred Drake d7acf02290 Adjustments to allow elements with subelements as parameters. This is used to deal with the table headings and entries. An additional flag in the element table is used to indicate elements which have no "general" content, but which do have subelement content. These must be flagged distinctly from empty elements. Currently used for \lineii, \lineiii, and \lineiv.		1999-01-14 17:38:12 +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	Adjustments to allow elements with subelements as parameters. This is	1999-01-14 17:38:12 +00:00
make.rules	Support conversions to both SGML and XML; SGML is the "default".	1998-12-01 19:05:56 +00:00
README	General comments on what's here and how to try it out. Note	1998-12-02 17:21:35 +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 highly 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 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).

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