cpython/Doc/tools/sgmlconv/README

31 lines
999 B
Plaintext
Raw Normal View History

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.
1999-01-14 14:12:33 -04:00
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.
1999-01-14 14:12:33 -04:00
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).
1999-01-14 14:12:33 -04:00
This is true regardless of whether you build SGML or XML first.
Please send comments and bug reports to python-docs@python.org.