diff options
| author | wiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2006-01-09 20:44:25 +0000 |
|---|---|---|
| committer | wiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2006-01-09 20:44:25 +0000 |
| commit | d77fdfef70e08114f57cbef5d91707df8717ea9f (patch) | |
| tree | 49444e3486c0c333cb7b33dfa721296c08ee4ece /sandbox/dkuhlman/README_docpy | |
| parent | 53cd16ca6ca5f638cbe5956988e88f9339e355cf (diff) | |
| parent | 3993c4097756e9885bcfbd07cb1cc1e4e95e50e4 (diff) | |
| download | docutils-0.4.tar.gz | |
Release 0.4: tagging released revisiondocutils-0.4
git-svn-id: http://svn.code.sf.net/p/docutils/code/tags/docutils-0.4@4268 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'sandbox/dkuhlman/README_docpy')
| -rw-r--r-- | sandbox/dkuhlman/README_docpy | 102 |
1 files changed, 0 insertions, 102 deletions
diff --git a/sandbox/dkuhlman/README_docpy b/sandbox/dkuhlman/README_docpy deleted file mode 100644 index f5dfec768..000000000 --- a/sandbox/dkuhlman/README_docpy +++ /dev/null @@ -1,102 +0,0 @@ -======================================================= -Python LaTeX -- reStructuredText for Documenting Python -======================================================= - - -What it does -- Python LaTeX generates LaTeX suitable as input to -the "Documenting Python" system. This system is described at: - - http://www.python.org/dev/doc/devel/doc/doc.html - - -Installation ------------- - -If you have a standard Docutils installation, then you should be -able to go to the parent directory of the ``docutils`` directory, -then do the following:: - - unzip rstdocpy-1.0b.zip - -This will create (overlay) the following files:: - - README_docpy - Docs/Makefile - Docs/pythonlatex_intro.txt - docutils/docs/rst/docpy.html - docutils/docutils/writers/python_latex.py - docutils/tools/python_latex.py - -In order to use the above files in place, you may have to do -something like:: - - export PYTHONPATH=/w1/Python/DocUtils/docutils:$PYTHONPATH - -You will also need the "Documenting Python" tools installed. They -are in the ``Doc`` directory of the Python source code -distribution. - - -Testing -------- - -After the above installation, you should be able to go to the -``Msgs`` directory and convert the document ``docpy_intro.rst``. - -First, edit the file ``Msgs/Makefile``. Change the path that -points to the location where the Python source code is installed. -Then type:: - - cd Msgs - make clean - make - - -Documentation -------------- - -The file ``Msgs/docpy_intro.rst`` contains an introduction. - -See the companion document 'Quick reStructuredText for -"Documenting Python"' (docutils/docs/rst/docpy.html) for -additional mark-up that can be used when generating LaTeX for -"Documenting Python". The first section of this document has -information specific to the generation of LaTeX for Documenting -Python. In addition, that document also adds another column to the -specification tables. This additional column describes the LaTeX -commands generated by this writer. - - -More Information ----------------- - -Find out more about Docutils at:: - - http://docutils.sourceforge.net/ - -More information about the Documenting Python system is at:: - - http://www.python.org/dev/doc/devel/doc/doc.html - - -Acknowledgements ------------------ - -Thanks to the Docutils project members for Docutils. In -particular, thanks to project coordinator David Goodger. - -Thanks to Engelbert Gruber for the implementation of the latex -writer. That implementation formed the starting point for this -writer. He should get much of the credit for this writer also, -however, any bugs were likely introduced by me. - - -Contact -------- - -Please let me know about suggestions and problems:: - - Dave Kuhlman - dkuhlman@rexx.com - http://www.rexx.com/~dkuhlman - |