| Fred Drake | 86bc7b0 | 1998-12-02 17:21:35 +0000 | [diff] [blame] | 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 | |
| Fred Drake | 7727416 | 1999-01-14 18:12:33 +0000 | [diff] [blame] | 5 | This material is preliminary and incomplete. The XML omnibus package |
| 6 | developed by the Python XML-SIG is required. See |
| Fred Drake | 86bc7b0 | 1998-12-02 17:21:35 +0000 | [diff] [blame] | 7 | http://www.python.org/sigs/xml-sig/ for more information on the |
| 8 | package. |
| 9 | |
| Fred Drake | 7727416 | 1999-01-14 18:12:33 +0000 | [diff] [blame] | 10 | To convert all documents to SGML: |
| 11 | |
| 12 | cd Doc/ |
| 13 | make -f tools/sgmlconv/Makefile |
| 14 | |
| Fred Drake | 86bc7b0 | 1998-12-02 17:21:35 +0000 | [diff] [blame] | 15 | To convert a document to SGML: |
| 16 | |
| 17 | cd Doc/<document-dir> |
| 18 | make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools |
| 19 | |
| 20 | To generate XML instead, use: |
| 21 | |
| 22 | cd Doc/<document-dir> |
| 23 | make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools xml |
| 24 | |
| 25 | Note that building the second target format is fast because both |
| 26 | conversions use the same intermediate format (an ESIS event stream). |
| Fred Drake | 7727416 | 1999-01-14 18:12:33 +0000 | [diff] [blame] | 27 | This is true regardless of whether you build SGML or XML first. |
| Fred Drake | 86bc7b0 | 1998-12-02 17:21:35 +0000 | [diff] [blame] | 28 | |
| 29 | Please send comments and bug reports to python-docs@python.org. |