cpython

History

Fred Drake 7dab6affba Update the docstring. Lots of changes to get the paragraph marking to work, and not go into an infinite recursion. Start to rationalize markup of method signatures; not complete. find_all_elements(): similar to getElementsByTagName(), but operates on the not-quite-legal fragments we deal with here. Simplifies several individual transforms. fixup_sectionauthors(): Convert \sectionauthor items to <author> just after the <section>'s <title>.		1999-01-28 23:59:58 +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	Update the docstring.	1999-01-28 23:59:58 +00:00
esis2sgml.py	Add "term" to AUTOCLOSE.	1999-01-22 22:48:24 +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	Added table entries for \methodline, \methodlineni.	1999-01-28 23:49:37 +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.