doc/changes/1.1.rst
PR#40: Fix safe_repr function to decode bytestrings with non-ASCII
characters correctly.
PR#37: Allow configuring sphinx-apidoc via SPHINX_APIDOC_OPTIONS.
PR#34: Restore Python 2.4 compatibility.
PR#36: Make the "bibliography to TOC" fix in LaTeX output specific to the document class.
#695: When the highlight language "python" is specified explicitly, do not try to parse the code to recognize non-Python snippets.
#859: Fix exception under certain circumstances when not finding appropriate objects to link to.
#860: Do not crash when encountering invalid doctest examples, just emit a warning.
#864: Fix crash with some settings of :confval:modindex_common_prefix.
#862: Fix handling of -D and -A options on Python 3.
#851: Recognize and warn about circular toctrees, instead of running into recursion errors.
#853: Restore compatibility with Docutils trunk.
#852: Fix HtmlHelp index entry links again.
#854: Fix inheritance_diagram raising attribute errors on builtins.
#832: Fix crashes when putting comments or lone terms in a glossary.
#834, #818: Fix HTML help language/encoding mapping for all Sphinx supported languages.
#844: Fix crashes when dealing with Unicode output in doctest extension.
#831: Provide --project flag in setup_command as advertised.
#875: Fix reading config files under Python 3.
#876: Fix quickstart test under Python 3.
#870: Fix spurious KeyErrors when removing documents.
#892: Fix single-HTML builder misbehaving with the master document in a subdirectory.
#873: Fix assertion errors with empty only directives.
#816: Fix encoding issues in the Qt help builder.
#791: Fix QtHelp, DevHelp and HtmlHelp index entry links.
#792: Include "sphinx-apidoc" in the source distribution.
#797: Don't crash on a misformatted glossary.
#801: Make intersphinx work properly without SSL support.
#805: Make the Sphinx.add_index_to_domain method work correctly.
#780: Fix Python 2.5 compatibility.
The py:module directive doesn't output its platform option
value anymore. (It was the only thing that the directive did output, and
therefore quite inconsistent.)
Removed support for old dependency versions; requirements are now:
Added Python 3.x support.
New builders and subsystems:
gettext builder and related
utilities.websupport library and builder.sphinx-apidoc script that autogenerates a hierarchy
of source files containing autodoc directives to document modules
and packages.Markup:
index role, to make inline index entries.toctree's numbered option.glossary markup which allows
multiple terms per definition.py:decorator directive to describe decorators.:param x: inside directives).only directives are now correctly
handled.emphasize-lines option to source code directives.HTML builder:
pyramid theme.html_add_permalinks is now a string giving the
text to display in permalinks.sidebarwidth to the basic theme.Other builders:
latex_show_urls option to
show the URLs in footnotes.text_newlines and :confval:text_sectionchars
config values.man_show_urls config value.linkcheck_timeout and :confval:linkcheck_workers.linkcheck_ignore config value.Configuration and extensibility:
nitpick_ignore.env-get-outdated event.!Application.add_stylesheet now accepts full URIs.Autodoc:
autodoc_docstring_signature. When enabled (the
default), autodoc retrieves the signature from the first line of the
docstring, if it is found there.private-members option for autodoc directives.special-members option for autodoc directives.functools.partial objects.Other extensions:
sphinx.ext.mathjax extension.inline option to graphviz directives, and fixed the
default (block-style) in LaTeX output.caption option to graphviz directives.testcleanup blocks in the doctest extension.trim_doctest_flags now also removes <BLANKLINE>
indicators.pngmath_add_tooltips.name in
addition to label for giving the equation label, for compatibility
with Docutils.New locales:
Bugs fixed: