[Python-checkins] r57058 - in doctools/trunk: Doc-26/README.txt Doc-26/TODO Doc-26/documenting/fromlatex.rst Doc-3k/README.txt Doc-3k/TODO Doc-3k/documenting/fromlatex.rst

[georg.brandl]

Author: georg.brandl
Date: Wed Aug 15 15:56:54 2007
New Revision: 57058

Modified:
   doctools/trunk/Doc-26/README.txt
   doctools/trunk/Doc-26/TODO
   doctools/trunk/Doc-26/documenting/fromlatex.rst
   doctools/trunk/Doc-3k/README.txt
   doctools/trunk/Doc-3k/TODO
   doctools/trunk/Doc-3k/documenting/fromlatex.rst
Log:
Update TODO and README.


Modified: doctools/trunk/Doc-26/README.txt
==============================================================================
--- doctools/trunk/Doc-26/README.txt	(original)
+++ doctools/trunk/Doc-26/README.txt	Wed Aug 15 15:56:54 2007
@@ -7,7 +7,8 @@
 
 Documentation on the authoring Python documentation, including information about
 both style and markup, is available in the "Documenting Python" chapter of the
-documentation.
+documentation.  There's also a chapter intended to point out differences to
+those familiar with the previous docs written in LaTeX.
 
 
 Building the docs

Modified: doctools/trunk/Doc-26/TODO
==============================================================================
--- doctools/trunk/Doc-26/TODO	(original)
+++ doctools/trunk/Doc-26/TODO	Wed Aug 15 15:56:54 2007
@@ -1,6 +1,6 @@
-To do after conversion
-======================
+To do
+=====
 
 * split very large files and add toctrees
-* find out which files get "comments disabled" metadata
 * finish "Documenting Python"
+* care about XXX comments

Modified: doctools/trunk/Doc-26/documenting/fromlatex.rst
==============================================================================
--- doctools/trunk/Doc-26/documenting/fromlatex.rst	(original)
+++ doctools/trunk/Doc-26/documenting/fromlatex.rst	Wed Aug 15 15:56:54 2007
@@ -164,4 +164,29 @@
         The equals operator.
 
 
+Structure
+---------
+
+The LaTeX docs were split in several toplevel manuals.  Now, all files
+are part of the same documentation tree, as indicated by the *toctree*
+directives in the sources.  Every *toctree* directive embeds other files
+as subdocuments of the current file (this structure is not necessarily
+mirrored in the filesystem layout).  The toplevel file is
+:file:`contents.rst`.
+
+However, most of the old directory structure has been kept, with the
+directories renamed as follows:
+
+* :file:`api` -> :file:`c-api`
+* :file:`dist` -> :file:`distutils`, with the single TeX file split up
+* :file:`doc` -> :file:`documenting`
+* :file:`ext` -> :file:`extending`
+* :file:`inst` -> :file:`installing`
+* :file:`lib` -> :file:`library`
+* :file:`mac` -> merged into :file:`library`, with `mac/using.tex`
+  moved to `howto/pythonmac.rst`
+* :file:`ref` -> :file:`reference`
+* :file:`tut` -> :file:`tutorial`, with the single TeX file split up
+
+
 .. XXX more (index-generating, production lists, ...)

Modified: doctools/trunk/Doc-3k/README.txt
==============================================================================
--- doctools/trunk/Doc-3k/README.txt	(original)
+++ doctools/trunk/Doc-3k/README.txt	Wed Aug 15 15:56:54 2007
@@ -7,7 +7,8 @@
 
 Documentation on the authoring Python documentation, including information about
 both style and markup, is available in the "Documenting Python" chapter of the
-documentation.
+documentation.  There's also a chapter intended to point out differences to
+those familiar with the previous docs written in LaTeX.
 
 
 Building the docs

Modified: doctools/trunk/Doc-3k/TODO
==============================================================================
--- doctools/trunk/Doc-3k/TODO	(original)
+++ doctools/trunk/Doc-3k/TODO	Wed Aug 15 15:56:54 2007
@@ -1,6 +1,6 @@
-To do after conversion
-======================
+To do
+=====
 
 * split very large files and add toctrees
-* find out which files get "comments disabled" metadata
 * finish "Documenting Python"
+* care about XXX comments

Modified: doctools/trunk/Doc-3k/documenting/fromlatex.rst
==============================================================================
--- doctools/trunk/Doc-3k/documenting/fromlatex.rst	(original)
+++ doctools/trunk/Doc-3k/documenting/fromlatex.rst	Wed Aug 15 15:56:54 2007
@@ -164,4 +164,29 @@
         The equals operator.
 
 
+Structure
+---------
+
+The LaTeX docs were split in several toplevel manuals.  Now, all files
+are part of the same documentation tree, as indicated by the *toctree*
+directives in the sources.  Every *toctree* directive embeds other files
+as subdocuments of the current file (this structure is not necessarily
+mirrored in the filesystem layout).  The toplevel file is
+:file:`contents.rst`.
+
+However, most of the old directory structure has been kept, with the
+directories renamed as follows:
+
+* :file:`api` -> :file:`c-api`
+* :file:`dist` -> :file:`distutils`, with the single TeX file split up
+* :file:`doc` -> :file:`documenting`
+* :file:`ext` -> :file:`extending`
+* :file:`inst` -> :file:`installing`
+* :file:`lib` -> :file:`library`
+* :file:`mac` -> merged into :file:`library`, with `mac/using.tex`
+  moved to `howto/pythonmac.rst`
+* :file:`ref` -> :file:`reference`
+* :file:`tut` -> :file:`tutorial`, with the single TeX file split up
+
+
 .. XXX more (index-generating, production lists, ...)