cpython

History

Fred Drake 43278f01dc convert(): Added parameter "autoclose", which should be a sequence of general identifiers for which closing tags will be omitted when SGML is generated. This can be used to tell the markup generator to drop stuff like </para>. Note that it needs to be possible for the closing tag to always be omitted for it to be included in "autoclose". main(): Added command-line option "-a" / "--autoclose" to set the list of general identifiers passed to the convert() function as the "autoclose" parameter. The list may only be specified once (not additive) and GIs should be comma-separated. The default list includes only "para".		1999-01-20 20:35:05 +00:00
..
Makefile	Modified the "sgml" and "xml" targets to stop if the sub-makes fail in	1999-01-20 17:26:56 +00:00
README	Add usage of the "driver" Makefile.	1999-01-14 18:12:33 +00:00
docfixer.py	create_module_info(): If there's a \moduleauthor, move it to an	1999-01-19 23:09:31 +00:00
esis2sgml.py	convert(): Added parameter "autoclose", which should be a sequence of	1999-01-20 20:35:05 +00:00
esistools.py	Utility functions and misc. classes used in handling ESIS data.	1998-12-01 19:00:58 +00:00
fixgenents.sh	Adjust so that we are no longer using special entities for well-known	1999-01-14 21:44:56 +00:00
latex2esis.py	Shorten the name of the <rfc> "number" attribute to "num".	1999-01-14 21:18:52 +00:00
make.rules	Added clean and clobber targets.	1999-01-14 18:26:23 +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.