1998-12-02 17:21:35 +00:00
|
|
|
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 18:12:33 +00:00
|
|
|
This material is preliminary and incomplete. The XML omnibus package
|
1999-01-29 22:35:23 +00:00
|
|
|
developed by the Python XML-SIG is required; specifically, the version
|
|
|
|
|
available in the public CVS repository. See
|
1998-12-02 17:21:35 +00:00
|
|
|
http://www.python.org/sigs/xml-sig/ for more information on the
|
|
|
|
|
package.
|
|
|
|
|
|
1999-01-14 18:12:33 +00:00
|
|
|
To convert all documents to SGML:
|
|
|
|
|
|
|
|
|
|
cd Doc/
|
|
|
|
|
make -f tools/sgmlconv/Makefile
|
|
|
|
|
|
1998-12-02 17:21:35 +00:00
|
|
|
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 18:12:33 +00:00
|
|
|
This is true regardless of whether you build SGML or XML first.
|
1998-12-02 17:21:35 +00:00
|
|
|
|
|
|
|
|
Please send comments and bug reports to python-docs@python.org.
|
