mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 03:22:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8
cpython/Doc/tools/sgmlconv
History
Fred Drake d24167baf2 Make <rfc> no longer an empty element but a container. The text 
currently generated by the LaTeX and LaTeX2HTML processes is generated
here as well, making it more flexible in the SGML version.

Reduce the <args> element so that <optional> goes away; just use
square brackets to indicate what's optional.  This makes it easier to
read than the LaTeX, and the processor can do any checking it needs to
in order to make sure it's legit.  Possible shortcoming: DSSSL
processors may need more explicit markup.  Can probably hack around it
for this case, but we'll see.
1999-01-14 21:18:03 +00:00
..
docfixer.py Make <rfc> no longer an empty element but a container. The text 1999-01-14 21:18:03 +00:00
esis2sgml.py Escape special characters on output. 1999-01-14 17:06:09 +00:00
esistools.py Utility functions and misc. classes used in handling ESIS data. 1998-12-01 19:00:58 +00:00
fixgenents.sh Handle SGML variant as well as XML variant. SGML is *much* more 1998-12-10 04:56:00 +00:00
latex2esis.py Elaborate a comment on the format of the table that drives the 1999-01-14 18:10:09 +00:00
make.rules Added clean and clobber targets. 1999-01-14 18:26:23 +00:00
Makefile Added clean and clobber targets. 1999-01-14 18:26:23 +00:00
README Add usage of the "driver" Makefile. 1999-01-14 18:12:33 +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.