Doc/tools/sgmlconv/README

   1 These scripts and Makefile fragment are used to convert the Python
   2 documentation in LaTeX format to SGML.  XML is also supported as a
   3 target, but is unlikely to be used.
   4
   5 This material is preliminary and incomplete.  The XML omnibus package
   6 developed by the Python XML-SIG is required; specifically, the version
   7 available in the public CVS repository.  See
   8 http://www.python.org/sigs/xml-sig/ for more information on the
   9 package.
  10
  11 To convert all documents to SGML:
  12
  13         cd Doc/
  14         make -f tools/sgmlconv/Makefile
  15
  16 To convert a document to SGML:
  17
  18         cd Doc/<document-dir>
  19         make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools
  20
  21 To generate XML instead, use:
  22
  23         cd Doc/<document-dir>
  24         make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools xml
  25
  26 Note that building the second target format is fast because both
  27 conversions use the same intermediate format (an ESIS event stream).
  28 This is true regardless of whether you build SGML or XML first.
  29
  30 Please send comments and bug reports to python-docs@python.org.