[Python-checkins] CVS: python/dist/src/Doc/tools/sgmlconv README,1.5,1.6

Fred L. Drake python-dev@python.org
Wed, 22 Nov 2000 08:58:27 -0800


Update of /cvsroot/python/python/dist/src/Doc/tools/sgmlconv
In directory slayer.i.sourceforge.net:/tmp/cvs-serv6393

Modified Files:
	README 
Log Message:

Update to reflect the process changes.
Remove the SGML aspects; there's too much XML momentum to worry about
the SGML flavor at this point.



Index: README
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/tools/sgmlconv/README,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -r1.5 -r1.6
*** README	1999/08/26 18:08:13	1.5
--- README	2000/11/22 16:58:25	1.6
***************
*** 1,19 ****
  These scripts and Makefile fragment are used to convert the Python
! documentation in LaTeX format to SGML or XML.  Though I originally
! thought that the XML was unlikely to be used, tool support for XML
! is increasing quickly enough that it may well be the final format.
! (It is the default output format when using the makefiles included
! here.)
! 
! 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.
  
  To convert all documents to XML:
  
  	cd Doc/
! 	make -f tools/sgmlconv/Makefile sgml
  
  To convert one document to XML:
--- 1,11 ----
  These scripts and Makefile fragment are used to convert the Python
! documentation in LaTeX format to XML.
  
+ This material is preliminary and incomplete.  Python 2.0 is required.
+ 
  To convert all documents to XML:
  
  	cd Doc/
! 	make -f tools/sgmlconv/Makefile
  
  To convert one document to XML:
***************
*** 22,34 ****
  	make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools
  
- To generate SGML instead, use:
- 
- 	cd Doc/<document-dir>
- 	make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools sgml
- 
- 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.
  
--- 14,17 ----
***************
*** 51,54 ****
--- 34,39 ----
      the same level as the top-level content elements.
  
+     The output of latex2esis.py gets saved as <filename>.esis1.
+ 
  docfixer.py
      This is the really painful part of the conversion.  Well, it's the 
***************
*** 64,68 ****
      After processing the fragment, a new ESIS data stream is written
      out.  Like the input, it may not represent a well-formed
!     document.
  
      The output of docfixer.py is what gets saved in <filename>.esis.
--- 49,53 ----
      After processing the fragment, a new ESIS data stream is written
      out.  Like the input, it may not represent a well-formed
!     document, but does represent a parsed entity.
  
      The output of docfixer.py is what gets saved in <filename>.esis.