georg at python
May 6, 2008, 7:58 AM
Post #1 of 1
(126 views)
Permalink
|
I'm pleased to announce the next minor version of Sphinx, the Python
documentation generation tool.
What is it?
===========
Sphinx is a tool that makes it easy to create intelligent and beautiful
documentation for Python projects (or other documents consisting of
multiple reStructuredText source files).
Its website is at <http://sphinx.pocoo.org/>.
Partial list of changes
=======================
(full list at http://sphinx.pocoo.org/changes.html)
* The ``toctree`` directive now supports a ``glob`` option that allows
glob-style entries in the content.
* A new config value, `exclude_dirs`, can be used to exclude whole
directories from the search for source files.
* The configuration directory (containing ``conf.py``) can now be set
independently from the source directory. For that, a new command-line
option ``-c`` has been added.
* A new directive ``tabularcolumns`` can be used to give a tabular column
specification for LaTeX output. Tables now use the ``tabulary`` package.
Table output is now much better, even with default settings.
Literal blocks can now be placed in tables, with several caveats.
* A new config value, `latex_use_parts`, can be used to enable parts in LaTeX
documents.
* Autodoc now skips inherited members for classes, unless you give the
new ``inherited-members`` option.
* A new config value, `autoclass_content`, selects if the docstring of the
class' ``__init__`` method is added to the directive's body.
* sphinx.ext.autodoc: descriptors are detected properly now.
* sphinx.latexwriter: implement all reST admonitions, not just ``note``
and ``warning``.
* Lots of little fixes to the LaTeX output and style.
Enjoy!
Georg
--
http://mail.python.org/mailman/listinfo/python-announce-list
Support the Python Software Foundation:
http://www.python.org/psf/donations.html
|
