cpython

mirror of https://github.com/python/cpython.git synced 2026-01-06 23:42:34 +00:00

History

Fred Drake 7dbde51f97 Make the default target xml instead of sgml. Use a temporary file to pass results from latex2esis.py to docfixer.py; this makes for better error detection by make (if the first pipeline stage fails, make wasn't catching it).		1999-07-22 13:56:51 +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
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

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.