cpython

History

Fred Drake bc2285eb60 Conversion specification, used by a new path through latex2esis.py. The specific markup conversion is coded here instead of an even more cryptic table in the code of latex2esis.py.		1999-07-29 22:03:11 +00:00
..
Makefile	Make the default target xml instead of sgml.	1999-07-22 13:57:12 +00:00
README	Minor update.	1999-07-29 22:01:39 +00:00
conversion.xml	Conversion specification, used by a new path through latex2esis.py.	1999-07-29 22:03:11 +00:00
docfixer.py	Lots of adjustments to deal with the document content now being stored	1999-05-10 19:36:52 +00:00
esis2sgml.py	Modify to perform "---" to "—" conversion outside of	1999-05-18 17:34:51 +00:00
esistools.py	ExtendedEsisBuilder.push(): Override inherited definition. We don't	1999-05-07 21:14:28 +00:00
fixgenents.sh	Remove the "---" to "—" conversion; this is wrong in verbatim	1999-05-18 17:33:01 +00:00
latex2esis.py	Enhanced docstring and some comments.	1999-05-19 17:37:37 +00:00
make.rules	Make the default target xml instead of sgml.	1999-07-22 13:56:51 +00:00

README

These scripts and Makefile fragment are used to convert the Python
documentation in LaTeX format to SGML or XML.  Though I originally
thought that the XML was unlikely to be used, tool support for XML
is increasing quickly enough that it may well be the final format.
(It is the default output format when using the makefiles included
here.)

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 sgml

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.