diff options
author | Georg Brandl <georg@python.org> | 2014-01-26 11:51:09 +0100 |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2014-01-26 11:51:09 +0100 |
commit | 4b0d09374e4c781cd991a0a1ff19547025e009b7 (patch) | |
tree | 031a6bce3bb6ad109935c01f226b89bdc425e60b /CHANGES | |
parent | f5bf48f8160352370a0620fc78f9a98984b03c39 (diff) | |
parent | 17415fdff3b2232b2b84cef56c959b8ff51963a6 (diff) | |
download | sphinx-4b0d09374e4c781cd991a0a1ff19547025e009b7.tar.gz |
merge with stable
Diffstat (limited to 'CHANGES')
-rw-r--r-- | CHANGES | 59 |
1 files changed, 38 insertions, 21 deletions
@@ -1,30 +1,40 @@ -Release 1.2.2 (in development) -============================== - -Bugs fixed ----------- - -* PR#211: When checking for existence of the :confval:`html_logo` file, check - the full relative path and not the basename. -* PR#212: Fix traceback with autodoc and ``__init__`` methods without docstring. -* PR#213: Fix a missing import in the setup command. -* #1357: Option names documented by :rst:dir:`option` are now again allowed to - not start with a dash or slash, and referencing them will work correctly. -* #1358: Fix handling of image paths outside of the source directory when using - the "wildcard" style reference. - -Documentation -------------- - -* Extended the :ref:`documentation about building extensions <dev-extensions>`. +Release 1.3 (in development) +============================ +Incompatible changes +-------------------- -Release 1.2.1 (released Jan 19, 2014) -===================================== +* Dropped support for Python 2.5 and 3.1. +* Removed the ``sphinx.ext.oldcmarkup`` extension. +* The deprecated config values ``exclude_trees``, ``exclude_dirnames`` and + ``unused_docs`` have been removed. +* A new node, ``sphinx.addnodes.literal_strong``, has been added, for text that + should appear literally (i.e. no smart quotes) in strong font. Custom writers + will have to be adapted to handle this node. + +New features +------------ + +* Added ``sphinx.ext.napoleon`` extension for NumPy and Google style docstring + support. +* PR#202: Allow "." and "~" prefixed references in ``:param:`` doc fields + for Python. +* PR#184: Add :confval:`autodoc_mock_imports`, allowing to mock imports of + external modules that need not be present when autodocumenting. +* #925: Allow list-typed config values to be provided on the command line, + like ``-D key=val1,val2``. +* #668: Allow line numbering of ``code-block`` and ``literalinclude`` directives + to start at an arbitrary line number, with a new ``lineno-start`` option. +* PR#172: The :rst:dir:`code-block` and :rst:dir:`literalinclude` directives now + can have a ``filename`` option that shows a filename before the code in the + output. +* Prompt for the document language in sphinx-quickstart. Bugs fixed ---------- +* #1174: Fix smart quotes being applied inside roles like :rst:role:`program` or + :rst:role:`makevar`. * #1335: Fix autosummary template overloading with exclamation prefix like ``{% extends "!autosummary/class.rst" %}`` cause infinite recursive function call. This was caused by PR#181. @@ -102,11 +112,18 @@ Bugs fixed * #1323: Fix emitting empty ``<ul>`` tags in the HTML writer, which is not valid HTML. * #1147: Don't emit a sidebar search box in the "singlehtml" builder. +* PR#211: When checking for existence of the :confval:`html_logo` file, check + the full relative path and not the basename. +* #1357: Option names documented by :rst:dir:`option` are now again allowed to + not start with a dash or slash, and referencing them will work correctly. +* #1358: Fix handling of image paths outside of the source directory when using + the "wildcard" style reference. Documentation ------------- * #1325: Added a "Intersphinx" tutorial section. (:file:`doc/tutorial.rst`) +* Extended the :ref:`documentation about building extensions <dev-extensions>`. Release 1.2 (released Dec 10, 2013) |