[Python-modules-commits] [sphinx] 01/03: New upstream version 1.6.3
Dmitry Shachnev
mitya57 at moszumanska.debian.org
Sun Jul 9 09:39:42 UTC 2017
This is an automated email from the git hooks/post-receive script.
mitya57 pushed a commit to branch debian/master
in repository sphinx.
commit 0924d5b6c9357f7b03261555c770e82089039953
Author: Dmitry Shachnev <mitya57 at gmail.com>
Date: Sun Jul 9 12:12:21 2017 +0300
New upstream version 1.6.3
---
AUTHORS | 6 +-
CHANGES | 358 ++++-
CONTRIBUTING.rst | 52 +-
EXAMPLES | 36 +-
LICENSE | 4 +-
Makefile | 34 +-
PKG-INFO | 2 +-
README.rst | 2 +-
Sphinx.egg-info/PKG-INFO | 2 +-
Sphinx.egg-info/SOURCES.txt | 275 ++--
Sphinx.egg-info/requires.txt | 5 +
babel.cfg | 13 +-
doc/_static/conf.py.txt | 7 +-
doc/builders.rst | 69 +-
doc/conf.py | 8 +-
doc/config.rst | 169 +--
doc/contents.rst | 1 +
doc/develop.rst | 60 +-
doc/domains.rst | 45 +-
doc/ext/autodoc.rst | 12 +-
doc/ext/autosectionlabel.rst | 16 +-
doc/ext/builtins.rst | 1 +
doc/ext/doctest.rst | 15 +-
doc/ext/example_google.py | 2 +-
doc/ext/example_numpy.py | 2 +-
doc/ext/graphviz.rst | 17 +-
doc/ext/imgconverter.rst | 30 +
doc/ext/math.rst | 14 +-
doc/extdev/appapi.rst | 44 +-
doc/extdev/builderapi.rst | 6 +
doc/extdev/collectorapi.rst | 9 +
doc/extdev/index.rst | 32 +
doc/extdev/logging.rst | 77 +
doc/extdev/nodes.rst | 1 -
doc/extdev/tutorial.rst | 25 +-
doc/extensions.rst | 2 +-
doc/faq.rst | 28 +-
doc/intl.rst | 2 +-
doc/intro.rst | 14 +-
doc/invocation.rst | 2 +-
doc/latex.rst | 555 ++++---
doc/markup/code.rst | 18 +-
doc/markup/misc.rst | 102 +-
doc/markup/toctree.rst | 2 +-
doc/rest.rst | 6 +-
doc/setuptools.rst | 178 +++
doc/templating.rst | 69 +-
doc/theming.rst | 80 +-
doc/tutorial.rst | 1 +
doc/web/api.rst | 21 +-
doc/web/quickstart.rst | 10 +-
doc/web/searchadapters.rst | 6 +-
doc/web/storagebackends.rst | 7 +-
setup.cfg | 5 +-
setup.py | 9 +
sphinx/__init__.py | 27 +-
sphinx/addnodes.py | 57 +-
sphinx/apidoc.py | 35 +-
sphinx/application.py | 815 +++++-----
sphinx/builders/__init__.py | 255 ++--
sphinx/builders/{epub.py => _epub_base.py} | 481 +++---
sphinx/builders/applehelp.py | 61 +-
sphinx/builders/changes.py | 49 +-
sphinx/builders/devhelp.py | 25 +-
sphinx/builders/dummy.py | 13 +
sphinx/builders/epub2.py | 100 ++
sphinx/builders/epub3.py | 318 ++--
sphinx/builders/gettext.py | 103 +-
sphinx/builders/html.py | 452 +++---
sphinx/builders/htmlhelp.py | 38 +-
sphinx/builders/latex.py | 195 +--
sphinx/builders/linkcheck.py | 73 +-
sphinx/builders/manpage.py | 37 +-
sphinx/builders/qthelp.py | 46 +-
sphinx/builders/texinfo.py | 92 +-
sphinx/builders/text.py | 25 +-
sphinx/builders/websupport.py | 167 +--
sphinx/builders/xml.py | 21 +-
sphinx/cmdline.py | 44 +-
sphinx/config.py | 110 +-
sphinx/deprecation.py | 10 +-
sphinx/directives/__init__.py | 26 +-
sphinx/directives/code.py | 471 +++---
sphinx/directives/other.py | 38 +-
sphinx/directives/patches.py | 8 +
sphinx/domains/__init__.py | 83 +-
sphinx/domains/c.py | 35 +-
sphinx/domains/cpp.py | 756 +++++++---
sphinx/domains/javascript.py | 272 +++-
sphinx/domains/python.py | 111 +-
sphinx/domains/rst.py | 23 +-
sphinx/domains/std.py | 196 ++-
sphinx/environment/__init__.py | 803 ++++------
sphinx/environment/adapters/__init__.py | 10 +
sphinx/environment/adapters/asset.py | 28 +
.../{managers => adapters}/indexentries.py | 64 +-
sphinx/environment/adapters/toctree.py | 336 +++++
sphinx/environment/collectors/__init__.py | 85 ++
sphinx/environment/collectors/asset.py | 149 ++
sphinx/environment/collectors/dependencies.py | 66 +
sphinx/environment/collectors/indexentries.py | 66 +
sphinx/environment/collectors/metadata.py | 79 +
sphinx/environment/collectors/title.py | 72 +
sphinx/environment/collectors/toctree.py | 294 ++++
sphinx/environment/managers/__init__.py | 37 -
sphinx/environment/managers/toctree.py | 565 -------
sphinx/errors.py | 10 +
sphinx/events.py | 87 ++
sphinx/ext/autodoc.py | 341 +++--
sphinx/ext/autosectionlabel.py | 14 +-
sphinx/ext/autosummary/__init__.py | 83 +-
sphinx/ext/autosummary/generate.py | 83 +-
sphinx/ext/coverage.py | 63 +-
sphinx/ext/doctest.py | 171 ++-
sphinx/ext/graphviz.py | 88 +-
sphinx/ext/ifconfig.py | 14 +-
sphinx/ext/imgconverter.py | 93 ++
sphinx/ext/imgmath.py | 263 ++--
sphinx/ext/inheritance_diagram.py | 39 +-
sphinx/ext/intersphinx.py | 223 ++-
sphinx/ext/linkcode.py | 9 +-
sphinx/ext/mathbase.py | 43 +-
sphinx/ext/mathjax.py | 2 +-
sphinx/ext/napoleon/__init__.py | 12 +-
sphinx/ext/napoleon/docstring.py | 169 ++-
sphinx/ext/napoleon/iterators.py | 21 +-
sphinx/ext/pngmath.py | 43 +-
sphinx/ext/todo.py | 51 +-
sphinx/ext/viewcode.py | 54 +-
sphinx/extension.py | 61 +
sphinx/highlighting.py | 49 +-
sphinx/io.py | 56 +-
sphinx/jinja2glue.py | 33 +-
sphinx/locale/__init__.py | 94 +-
sphinx/locale/bn/LC_MESSAGES/sphinx.mo | Bin 14336 -> 23427 bytes
sphinx/locale/bn/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/ca/LC_MESSAGES/sphinx.mo | Bin 11323 -> 20484 bytes
sphinx/locale/ca/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/cs/LC_MESSAGES/sphinx.mo | Bin 11471 -> 20620 bytes
sphinx/locale/cs/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/cy/LC_MESSAGES/sphinx.mo | Bin 11380 -> 20533 bytes
sphinx/locale/cy/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/da/LC_MESSAGES/sphinx.mo | Bin 11231 -> 20397 bytes
sphinx/locale/da/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/de/LC_MESSAGES/sphinx.mo | Bin 11555 -> 20703 bytes
sphinx/locale/de/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/el/LC_MESSAGES/sphinx.mo | Bin 14824 -> 23914 bytes
sphinx/locale/el/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/eo/LC_MESSAGES/sphinx.mo | Bin 11147 -> 20313 bytes
sphinx/locale/eo/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/es/LC_MESSAGES/sphinx.mo | Bin 11933 -> 21212 bytes
sphinx/locale/es/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/et/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/et/LC_MESSAGES/sphinx.mo | Bin 11325 -> 20591 bytes
sphinx/locale/et/LC_MESSAGES/sphinx.po | 830 ++++++++---
sphinx/locale/eu/LC_MESSAGES/sphinx.mo | Bin 11410 -> 20567 bytes
sphinx/locale/eu/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/fa/LC_MESSAGES/sphinx.mo | Bin 11888 -> 21054 bytes
sphinx/locale/fa/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/fi/LC_MESSAGES/sphinx.mo | Bin 10971 -> 20136 bytes
sphinx/locale/fi/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/fr/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/fr/LC_MESSAGES/sphinx.mo | Bin 11836 -> 21047 bytes
sphinx/locale/fr/LC_MESSAGES/sphinx.po | 828 ++++++++---
sphinx/locale/he/LC_MESSAGES/sphinx.mo | Bin 11691 -> 20853 bytes
sphinx/locale/he/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/hi/LC_MESSAGES/sphinx.mo | Bin 11591 -> 20757 bytes
sphinx/locale/hi/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/hr/LC_MESSAGES/sphinx.mo | Bin 11339 -> 20612 bytes
sphinx/locale/hr/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/hu/LC_MESSAGES/sphinx.mo | Bin 11793 -> 20947 bytes
sphinx/locale/hu/LC_MESSAGES/sphinx.po | 811 +++++++---
sphinx/locale/id/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/id/LC_MESSAGES/sphinx.mo | Bin 11216 -> 20375 bytes
sphinx/locale/id/LC_MESSAGES/sphinx.po | 828 ++++++++---
sphinx/locale/it/LC_MESSAGES/sphinx.mo | Bin 11635 -> 20836 bytes
sphinx/locale/it/LC_MESSAGES/sphinx.po | 806 +++++++---
sphinx/locale/ja/LC_MESSAGES/sphinx.mo | Bin 12237 -> 23241 bytes
sphinx/locale/ja/LC_MESSAGES/sphinx.po | 816 +++++++---
sphinx/locale/ko/LC_MESSAGES/sphinx.mo | Bin 11185 -> 20367 bytes
sphinx/locale/ko/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/lt/LC_MESSAGES/sphinx.mo | Bin 11626 -> 20787 bytes
sphinx/locale/lt/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/lv/LC_MESSAGES/sphinx.mo | Bin 11546 -> 20691 bytes
sphinx/locale/lv/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/mk/LC_MESSAGES/sphinx.mo | Bin 11469 -> 20635 bytes
sphinx/locale/mk/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo | Bin 11045 -> 20207 bytes
sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/ne/LC_MESSAGES/sphinx.mo | Bin 13874 -> 22966 bytes
sphinx/locale/ne/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/nl/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/nl/LC_MESSAGES/sphinx.mo | Bin 11445 -> 21244 bytes
sphinx/locale/nl/LC_MESSAGES/sphinx.po | 850 ++++++++---
sphinx/locale/pl/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/pl/LC_MESSAGES/sphinx.mo | Bin 11578 -> 20979 bytes
sphinx/locale/pl/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo | Bin 11674 -> 20816 bytes
sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo | Bin 11678 -> 20828 bytes
sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/ro/LC_MESSAGES/sphinx.mo | Bin 11655 -> 20805 bytes
sphinx/locale/ro/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/ru/LC_MESSAGES/sphinx.mo | Bin 14547 -> 23631 bytes
sphinx/locale/ru/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/si/LC_MESSAGES/sphinx.mo | Bin 11984 -> 21150 bytes
sphinx/locale/si/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/sk/LC_MESSAGES/sphinx.mo | Bin 11507 -> 21046 bytes
sphinx/locale/sk/LC_MESSAGES/sphinx.po | 800 +++++++---
sphinx/locale/sl/LC_MESSAGES/sphinx.mo | Bin 11265 -> 20417 bytes
sphinx/locale/sl/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/sphinx.pot | 802 +++++++---
sphinx/locale/sr/LC_MESSAGES/sphinx.js | 1 +
sphinx/locale/sr/LC_MESSAGES/sphinx.mo | Bin 0 -> 20367 bytes
sphinx/locale/sr/LC_MESSAGES/sphinx.po | 1314 +++++++++++++++++
sphinx/locale/sr at latin/LC_MESSAGES/sphinx.js | 1 +
sphinx/locale/sr at latin/LC_MESSAGES/sphinx.mo | Bin 0 -> 20381 bytes
sphinx/locale/sr at latin/LC_MESSAGES/sphinx.po | 1314 +++++++++++++++++
sphinx/locale/sv/LC_MESSAGES/sphinx.mo | Bin 11087 -> 20239 bytes
sphinx/locale/sv/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/tr/LC_MESSAGES/sphinx.mo | Bin 11658 -> 20828 bytes
sphinx/locale/tr/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo | Bin 12847 -> 22013 bytes
sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/vi/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/vi/LC_MESSAGES/sphinx.mo | Bin 11688 -> 20855 bytes
sphinx/locale/vi/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo | Bin 10778 -> 19984 bytes
sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po | 802 +++++++---
sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js | 2 +-
sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo | Bin 10945 -> 20079 bytes
sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po | 847 ++++++++---
sphinx/make_mode.py | 64 +-
sphinx/parsers.py | 34 +
sphinx/pycode/__init__.py | 47 +-
sphinx/pycode/nodes.py | 10 +-
sphinx/pycode/pgen2/grammar.py | 18 +-
sphinx/pycode/pgen2/parse.py | 15 +-
sphinx/pycode/pgen2/pgen.py | 25 +-
sphinx/pycode/pgen2/tokenize.py | 16 +-
sphinx/quickstart.py | 36 +-
sphinx/registry.py | 226 +++
sphinx/roles.py | 42 +-
sphinx/search/__init__.py | 100 +-
sphinx/search/en.py | 31 +-
sphinx/search/ja.py | 25 +-
sphinx/search/ro.py | 8 +-
sphinx/search/tr.py | 8 +-
sphinx/search/zh.py | 39 +-
sphinx/setup_command.py | 86 +-
sphinx/templates/epub2/container.xml | 6 +
sphinx/templates/epub2/content.opf_t | 37 +
sphinx/templates/epub2/mimetype | 1 +
sphinx/templates/epub2/toc.ncx_t | 15 +
sphinx/templates/epub3/container.xml | 6 +
sphinx/templates/epub3/content.opf_t | 46 +
sphinx/templates/epub3/mimetype | 1 +
sphinx/templates/epub3/nav.xhtml_t | 26 +
sphinx/templates/epub3/toc.ncx_t | 24 +
.../templates/latex/{content.tex_t => latex.tex_t} | 4 +-
sphinx/templates/latex/longtable.tex_t | 32 +
sphinx/templates/latex/tabular.tex_t | 27 +
sphinx/templates/latex/tabulary.tex_t | 27 +
sphinx/templates/quickstart/Makefile.new_t | 2 +-
sphinx/templates/quickstart/Makefile_t | 2 +-
sphinx/templates/quickstart/conf.py_t | 15 +
sphinx/templates/quickstart/make.bat.new_t | 10 +-
sphinx/templates/quickstart/make.bat_t | 27 +-
sphinx/testing/__init__.py | 15 +
tests/conftest.py => sphinx/testing/fixtures.py | 81 +-
{tests => sphinx/testing}/path.py | 9 +-
{tests => sphinx/testing}/util.py | 69 +-
sphinx/texinputs/Makefile_t | 98 +-
sphinx/texinputs/footnotehyper-sphinx.sty | 372 +++--
sphinx/texinputs/latexmkjarc | 7 +
sphinx/texinputs/latexmkrc_t | 17 +
sphinx/texinputs/needspace.sty | 35 -
sphinx/texinputs/sphinx.sty | 368 +++--
sphinx/texinputs/sphinxhowto.cls | 19 +-
sphinx/texinputs/sphinxmanual.cls | 19 +-
sphinx/texinputs/sphinxmulticell.sty | 317 ++++
sphinx/themes/basic/layout.html | 34 +-
sphinx/themes/basic/static/basic.css_t | 7 +
sphinx/themes/epub/static/epub.css_t | 126 +-
sphinx/themes/scrolls/layout.html | 5 +-
sphinx/theming.py | 378 ++---
sphinx/transforms/__init__.py | 175 ++-
sphinx/transforms/compact_bullet_list.py | 13 +-
sphinx/transforms/i18n.py | 85 +-
sphinx/transforms/post_transforms/__init__.py | 209 +++
sphinx/transforms/post_transforms/images.py | 263 ++++
sphinx/util/__init__.py | 200 ++-
sphinx/util/compat.py | 56 +-
sphinx/util/console.py | 18 +-
sphinx/util/docfields.py | 67 +-
sphinx/util/docstrings.py | 6 +
sphinx/util/docutils.py | 107 +-
sphinx/util/fileutil.py | 12 +-
sphinx/util/i18n.py | 104 +-
sphinx/util/images.py | 98 +-
sphinx/util/inspect.py | 122 +-
sphinx/util/inventory.py | 191 +++
sphinx/util/jsdump.py | 22 +-
sphinx/util/jsonimpl.py | 11 +-
sphinx/util/logging.py | 431 ++++++
sphinx/util/matching.py | 15 +-
sphinx/util/nodes.py | 97 +-
sphinx/util/osutil.py | 38 +-
sphinx/util/parallel.py | 53 +-
sphinx/util/png.py | 2 +
sphinx/util/pycompat.py | 130 +-
sphinx/util/requests.py | 18 +-
sphinx/util/rst.py | 5 +-
sphinx/util/smartypants.py | 626 ++++----
sphinx/util/stemmer/__init__.py | 51 +
sphinx/util/{stemmer.py => stemmer/porter.py} | 25 +-
sphinx/util/tags.py | 27 +-
sphinx/util/template.py | 26 +-
sphinx/util/texescape.py | 4 +-
sphinx/util/typing.py | 24 +
sphinx/util/websupport.py | 9 +-
sphinx/versioning.py | 13 +-
sphinx/websupport/__init__.py | 457 +-----
sphinx/websupport/errors.py | 16 +-
sphinx/websupport/search/__init__.py | 124 +-
sphinx/websupport/search/nullsearch.py | 14 +-
sphinx/websupport/search/whooshsearch.py | 51 +-
sphinx/websupport/search/xapiansearch.py | 76 +-
sphinx/websupport/storage/__init__.py | 106 +-
sphinx/websupport/storage/differ.py | 76 +-
sphinx/websupport/storage/sqlalchemy_db.py | 211 +--
sphinx/websupport/storage/sqlalchemystorage.py | 167 +--
sphinx/writers/html.py | 276 ++--
sphinx/writers/{html.py => html5.py} | 367 +++--
sphinx/writers/latex.py | 905 ++++++++----
sphinx/writers/manpage.py | 119 +-
sphinx/writers/texinfo.py | 361 ++++-
sphinx/writers/text.py | 272 +++-
sphinx/writers/websupport.py | 36 +-
sphinx/writers/xml.py | 15 +-
test-reqs.txt | 2 +
tests/conftest.py | 236 +--
tests/etree13/ElementPath.py | 226 +++
tests/etree13/ElementTree.py | 1553 ++++++++++++++++++++
tests/py35/test_autodoc_py35.py | 14 +-
tests/root/markup.txt | 432 ------
tests/roots/test-build-html-translator/conf.py | 19 +
tests/roots/test-build-html-translator/index.rst | 24 +
tests/roots/test-directive-code/dedent.rst | 35 -
tests/roots/test-directive-code/dedent_code.rst | 53 -
tests/roots/test-directive-code/lineno_match.rst | 26 -
tests/roots/test-directive-code/lineno_start.rst | 6 -
tests/roots/test-directive-code/linenos.rst | 12 +
.../test-directive-code/literal-diff.inc} | 3 +-
tests/roots/test-directive-code/py-decorators.inc | 16 +
tests/roots/test-directive-code/py-decorators.rst | 17 +
tests/roots/test-directive-code/target.py | 5 +
.../conf.py | 0
tests/roots/test-directives-raw/index.rst | 40 +
tests/roots/test-doctest/doctest.txt | 16 +-
tests/roots/test-domain-js/index.rst | 1 +
tests/roots/test-domain-js/module.rst | 27 +
tests/roots/test-double-inheriting-theme/conf.py | 1 +
.../conf.py | 5 +
.../index.rst | 25 +
.../autosummary_dummy_module.py | 9 +
tests/roots/test-ext-autosummary/conf.py | 9 +
tests/roots/test-ext-autosummary/contents.rst | 6 +
.../conf.py | 1 +
tests/roots/test-ext-imgconverter/index.rst | 4 +
.../test-ext-imgconverter}/svgimg.svg | 0
.../conf.py | 1 +
.../roots/test-ext-intersphinx-cppdomain/index.rst | 6 +
tests/roots/test-ext-viewcode/spam/mod1.py | 5 +
tests/roots/test-ext-viewcode/spam/mod2.py | 5 +
tests/roots/test-image-glob/index.rst | 16 -
.../roots/{test-image-glob => test-images}/conf.py | 0
tests/{root => roots/test-images}/img.gif | Bin
.../{test-image-glob => test-images}/img.ja.png | Bin
tests/{root => roots/test-images}/img.pdf | Bin
tests/{root => roots/test-images}/img.png | Bin
.../{test-image-glob => test-images}/img.zh.png | Bin
tests/roots/test-images/index.rst | 22 +
tests/{root => roots/test-images}/rimg.png | Bin
.../{test-image-glob => test-images}/rimg.png.xx | Bin
.../{test-image-glob => test-images}/rimg.xx.png | Bin
.../subdir/index.rst | 4 +-
.../subdir}/rimg.png | Bin
.../subdir/rimg.xx.png | Bin
.../{root => roots/test-images/subdir}/svgimg.pdf | Bin
.../subdir/svgimg.svg | 0
.../subdir/svgimg.xx.svg | 0
.../roots/test-images/testima\314\210ge.png" | Bin
tests/roots/test-latex-table/complex.rst | 35 +
tests/roots/test-latex-table/conf.py | 7 +
.../expects/complex_spanning_cell.tex | 57 +
tests/roots/test-latex-table/expects/gridtable.tex | 56 +
tests/roots/test-latex-table/expects/longtable.tex | 45 +
.../expects/longtable_having_align.tex | 45 +
.../expects/longtable_having_caption.tex | 46 +
.../expects/longtable_having_problematic_cell.tex | 51 +
...le_having_stub_columns_and_problematic_cell.tex | 54 +
.../expects/longtable_having_verbatim.tex | 47 +
.../expects/longtable_having_widths.tex | 45 +
...ongtable_having_widths_and_problematic_cell.tex | 51 +
.../expects/longtable_with_tabularcolumn.tex | 45 +
.../test-latex-table/expects/simple_table.tex | 30 +
.../expects/table_having_caption.tex | 33 +
.../expects/table_having_problematic_cell.tex | 36 +
...le_having_stub_columns_and_problematic_cell.tex | 37 +
.../expects/table_having_verbatim.tex | 32 +
.../expects/table_having_widths.tex | 30 +
.../table_having_widths_and_problematic_cell.tex | 36 +
.../expects/tabular_having_widths.tex | 30 +
.../test-latex-table/expects/tabularcolumn.tex | 30 +
.../expects/tabulary_having_widths.tex | 30 +
tests/roots/test-latex-table/index.rst | 8 +
tests/roots/test-latex-table/longtable.rst | 151 ++
tests/roots/test-latex-table/tabular.rst | 153 ++
tests/{root => roots/test-root}/Makefile | 7 +-
tests/{root => roots/test-root}/_static/README | 0
.../{root => roots/test-root}/_static/excluded.css | 0
.../test-root}/_static/subdir/foo.css | 0
.../test-root}/_templates/contentssb.html | 0
.../test-root}/_templates/customsb.html | 0
.../test-root}/_templates/layout.html | 0
tests/{root => roots/test-root}/autodoc.txt | 0
tests/{root => roots/test-root}/autodoc_fodder.py | 0
.../test-root}/autodoc_missing_imports.py | 0
tests/{root => roots/test-root}/bom.po | 0
tests/{root => roots/test-root}/bom.txt | 0
tests/{root => roots/test-root}/conf.py | 2 +-
tests/{root => roots/test-root}/contents.txt | 0
.../test-root}/en.lproj/localized.txt | 0
tests/{root => roots/test-root}/ext.py | 0
tests/{root => roots/test-root}/extapi.txt | 0
tests/{root => roots/test-root}/extensions.txt | 0
tests/{root => roots/test-root}/footnote.txt | 11 +-
tests/{root => roots/test-root}/images.txt | 2 +-
tests/{root => roots/test-root}/img.foo.png | Bin
tests/roots/{test-image-glob => test-root}/img.gif | Bin
tests/roots/{test-image-glob => test-root}/img.pdf | Bin
tests/{root/subdir => roots/test-root}/img.png | Bin
tests/{root => roots/test-root}/includes.txt | 0
tests/{root => roots/test-root}/lists.txt | 0
tests/{root => roots/test-root}/literal.inc | 0
tests/{root => roots/test-root}/literal_orig.inc | 0
.../{test-searchadapters => test-root}/markup.txt | 35 +-
tests/{root => roots/test-root}/math.txt | 0
tests/{root => roots/test-root}/metadata.add | 0
tests/{root => roots/test-root}/objects.txt | 0
tests/{root => roots/test-root}/otherext.foo | 0
tests/{root => roots/test-root}/parsermod.py | 0
tests/{root => roots/test-root}/quotes.inc | 0
.../{test-image-glob/subdir => test-root}/rimg.png | Bin
tests/{root => roots/test-root}/robots.txt | 0
tests/{root => roots/test-root}/special/api.h | 0
tests/{root => roots/test-root}/special/code.py | 0
tests/{root => roots/test-root}/subdir.po | 0
.../{root => roots/test-root}/subdir/excluded.txt | 0
tests/{root => roots/test-root}/subdir/images.txt | 0
.../{test-image-glob => test-root/subdir}/img.png | Bin
tests/{root => roots/test-root}/subdir/include.inc | 0
.../{root => roots/test-root}/subdir/includes.txt | 0
tests/{root => roots/test-root}/subdir/simg.png | Bin
.../subdir => test-root}/svgimg.pdf | Bin
tests/{root => roots/test-root}/svgimg.svg | 0
tests/{root => roots/test-root}/tabs.inc | 0
tests/{root => roots/test-root}/templated.css_t | 0
tests/{root => roots/test-root}/test.inc | 0
.../test-root}/testtheme/layout.html | 0
.../test-root}/testtheme/static/staticimg.png | Bin
.../test-root}/testtheme/static/statictmpl.html_t | 0
.../{root => roots/test-root}/testtheme/theme.conf | 0
tests/{root => roots/test-root}/wrongenc.inc | 0
tests/{root => roots/test-root}/ziptheme.zip | Bin
tests/roots/test-searchadapters/conf.py | 4 -
.../roots/test-stylesheets/_templates/layout.html | 8 +
tests/roots/test-stylesheets/conf.py | 12 +
tests/roots/test-stylesheets/index.rst | 4 +
tests/roots/test-theming/child.zip | Bin 0 -> 661 bytes
tests/roots/test-theming/conf.py | 1 +
.../ziptheme.zip => roots/test-theming/parent.zip} | Bin
tests/roots/test-warnings/index.rst | 3 -
tests/run.py | 18 +-
tests/test_api_translator.py | 79 +-
tests/test_apidoc.py | 33 +-
tests/test_application.py | 51 +-
tests/test_autodoc.py | 22 +-
tests/test_build.py | 17 +-
tests/test_build_applehelp.py | 2 +-
tests/test_build_epub.py | 249 ++++
tests/test_build_html.py | 131 +-
tests/test_build_html5.py | 328 +++++
tests/test_build_latex.py | 272 +++-
tests/test_build_texinfo.py | 4 +-
tests/test_build_text.py | 2 +-
tests/test_catalogs.py | 37 +-
tests/test_config.py | 35 +-
tests/test_directive_code.py | 483 ++++--
tests/test_docutilsconf.py | 9 +-
tests/test_domain_cpp.py | 16 +-
tests/test_domain_js.py | 144 +-
tests/test_domain_py.py | 36 +-
tests/test_domain_std.py | 20 +
tests/test_environment.py | 42 +-
tests/test_environment_indexentries.py | 2 +-
tests/test_environment_toctree.py | 8 +-
tests/test_ext_autosectionlabel.py | 6 +
tests/test_ext_autosummary.py | 25 +-
tests/test_ext_doctest.py | 16 +
tests/test_ext_graphviz.py | 16 +-
tests/test_ext_imgconverter.py | 24 +
tests/test_ext_inheritance_diagram.py | 7 +-
tests/test_ext_intersphinx.py | 237 +--
tests/test_ext_math.py | 10 +-
tests/test_ext_napoleon_docstring.py | 4 +-
tests/test_ext_viewcode.py | 1 +
tests/test_highlighting.py | 15 +-
tests/test_intl.py | 28 +-
tests/test_markup.py | 13 +-
tests/test_metadata.py | 4 +-
tests/test_pycode.py | 90 ++
tests/test_quickstart.py | 2 +-
tests/test_searchadapters.py | 69 -
tests/test_setup_command.py | 34 +-
tests/test_theming.py | 45 +-
tests/test_util.py | 60 +-
tests/test_util_i18n.py | 21 +-
tests/test_util_images.py | 100 ++
tests/test_util_inspect.py | 62 +
tests/test_util_inventory.py | 74 +
tests/test_util_logging.py | 248 ++++
tests/test_util_rst.py | 4 +-
tests/test_versioning.py | 15 +-
tests/test_websupport.py | 250 +---
tox.ini | 16 +-
utils/CHANGES_template | 3 +
utils/bump_version.py | 56 +-
utils/check_sources.py | 3 +
utils/release-checklist | 11 +-
541 files changed, 49578 insertions(+), 18811 deletions(-)
diff --git a/AUTHORS b/AUTHORS
index 2489798..580feeb 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -12,6 +12,8 @@ Other co-maintainers:
* Robert Lehmann <@lehmannro>
* Roland Meister <@rolmei>
* Takeshi Komiya <@tk0miya>
+* Jean-François Burnol <@jfbu>
+* Yoshiki Shibukawa <@shibu_jp>
Other contributors, listed alphabetically, are:
@@ -20,7 +22,7 @@ Other contributors, listed alphabetically, are:
* Jakob Lykke Andersen -- Rewritten C++ domain
* Henrique Bastos -- SVG support for graphviz extension
* Daniel Bültmann -- todo extension
-* Jean-François Burnol -- LaTeX improvements
+* Marco Buttu -- doctest extension (pyversion option)
* Etienne Desautels -- apidoc module
* Michael Droettboom -- inheritance_diagram extension
* Charles Duffy -- original graphviz extension
@@ -54,7 +56,6 @@ Other contributors, listed alphabetically, are:
* Rob Ruana -- napoleon extension
* Stefan Seefeld -- toctree improvements
* Gregory Szorc -- performance improvements
-* Shibukawa Yoshiki -- pluggable search API and Japanese search, epub3 builder improvements
* Taku Shimizu -- epub3 builder
* Antonio Valentino -- qthelp builder
* Filip Vavera -- napoleon todo directive
@@ -67,6 +68,7 @@ Other contributors, listed alphabetically, are:
* Michael Wilson -- Intersphinx HTTP basic auth support
* Joel Wurtz -- cellspanning support in LaTeX
* Hong Xu -- svg support in imgmath extension and various bug fixes
+* Stephen Finucane -- setup command improvements and documentation
Many thanks for all contributions!
diff --git a/CHANGES b/CHANGES
index 4b69d36..487bee7 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,346 @@
+Release 1.6.3 (released Jul 02, 2017)
+=====================================
+
+Features added
+--------------
+
+* latex: hint that code-block continues on next page (refs: #3764, #3792)
+
+Bugs fixed
+----------
+
+* #3821: Failed to import sphinx.util.compat with docutils-0.14rc1
+* #3829: sphinx-quickstart template is incomplete regarding use of alabaster
+* #3772: 'str object' has no attribute 'filename'
+* Emit wrong warnings if citation label includes hyphens (refs: #3565)
+* #3858: Some warnings are not colored when using --color option
+* #3775: Remove unwanted whitespace in default template
+* #3835: sphinx.ext.imgmath fails to convert SVG images if project directory
+ name contains spaces
+* #3850: Fix color handling in make mode's help command
+* #3865: use of self.env.warn in sphinx extension fails
+* #3824: production lists apply smart quotes transform since Sphinx 1.6.1
+* latex: fix ``\sphinxbfcode`` swallows initial space of argument
+* #3878: Quotes in auto-documented class attributes should be straight quotes
+ in PDF output
+* #3881: LaTeX figure floated to next page sometimes leaves extra vertical
+ whitespace
+* #3885: duplicated footnotes raises IndexError
+* #3873: Failure of deprecation warning mechanism of
+ ``sphinx.util.compat.Directive``
+* #3874: Bogus warnings for "citation not referenced" for cross-file citations
+* #3860: Don't download images when builders not supported images
+* #3860: Remote image URIs without filename break builders not supported remote
+ images
+* #3833: command line messages are translated unintentionally with ``language``
+ setting.
+* #3840: make checking ``epub_uid`` strict
+* #3851, #3706: Fix about box drawing characters for PDF output
+* #3900: autosummary could not find methods
+* #3902: Emit error if ``latex_documents`` contains non-unicode string in py2
+
+Release 1.6.2 (released May 28, 2017)
+=====================================
+
+Incompatible changes
+--------------------
+
+* #3789: Do not require typing module for python>=3.5
+
+Bugs fixed
+----------
+
+* #3754: HTML builder crashes if HTML theme appends own stylesheets
+* #3756: epub: Entity 'mdash' not defined
+* #3758: Sphinx crashed if logs are emitted in conf.py
+* #3755: incorrectly warns about dedent with literalinclude
+* #3742: `RTD <https://readthedocs.org/>`_ PDF builds of Sphinx own docs are
+ missing an index entry in the bookmarks and table of contents. This is
+ `rtfd/readthedocs.org#2857
+ <https://github.com/rtfd/readthedocs.org/issues/2857>`_ issue, a workaround
+ is obtained using some extra LaTeX code in Sphinx's own :file:`conf.py`
+* #3770: Build fails when a "code-block" has the option emphasize-lines and the
+ number indicated is higher than the number of lines
+* #3774: Incremental HTML building broken when using citations
+* #3763: got epubcheck validations error if epub_cover is set
+* #3779: 'ImportError' in sphinx.ext.autodoc due to broken 'sys.meta_path'.
+ Thanks to Tatiana Tereshchenko.
+* #3796: env.resolve_references() crashes when non-document node given
+* #3803: Sphinx crashes with invalid PO files
+* #3791: PDF "continued on next page" for long tables isn't internationalized
+* #3788: smartquotes emits warnings for unsupported languages
+* #3807: latex Makefile for ``make latexpdf`` is only for unixen
+* #3781: double hyphens in option directive are compiled as endashes
+* #3817: latex builder raises AttributeError
+
+Release 1.6.1 (released May 16, 2017)
+=====================================
+
+Dependencies
+------------
+
+1.6b1
+
+* (updated) latex output is tested with Ubuntu trusty's texlive packages (Feb.
+ 2014) and earlier tex installations may not be fully compliant, particularly
+ regarding Unicode engines xelatex and lualatex
+* (added) latexmk is required for ``make latexpdf`` on GNU/Linux and Mac OS X
+ (refs: #3082)
+
+Incompatible changes
+--------------------
+
+1.6b1
+
+* #1061, #2336, #3235: Now generation of autosummary doesn't contain imported
+ members by default. Thanks to Luc Saffre.
+* LaTeX ``\includegraphics`` command isn't overloaded: only ``\sphinxincludegraphics``
+ has the custom code to fit image to available width if oversized.
+* The subclasses of ``sphinx.domains.Index`` should override ``generate()``
+ method. The default implementation raises NotImplementedError
+* LaTeX positioned long tables horizontally centered, and short ones
+ flushed left (no text flow around table.) The position now defaults to center in
+ both cases, and it will obey Docutils 0.13 ``:align:`` option (refs #3415, #3377)
+* option directive also allows all punctuations for the option name (refs: #3366)
+* #3413: if :rst:dir:`literalinclude`'s ``:start-after:`` is used, make ``:lines:``
+ relative (refs #3412)
+* ``literalinclude`` directive does not allow the combination of ``:diff:``
+ option and other options (refs: #3416)
+* LuaLaTeX engine uses ``fontspec`` like XeLaTeX. It is advised ``latex_engine
+ = 'lualatex'`` be used only on up-to-date TeX installs (refs #3070, #3466)
+* :confval:`latex_keep_old_macro_names` default value has been changed from
+ ``True`` to ``False``. This means that some LaTeX macros for styling are
+ by default defined only with ``\sphinx..`` prefixed names. (refs: #3429)
+* Footer "Continued on next page" of LaTeX longtable's now not framed (refs: #3497)
+* #3529: The arguments of ``BuildEnvironment.__init__`` is changed
+* #3082: Use latexmk for pdf (and dvi) targets (Unix-like platforms only)
+* #3558: Emit warnings if footnotes and citations are not referenced. The
+ warnings can be suppressed by ``suppress_warnings``.
+* latex made available (non documented) colour macros from a file distributed
+ with pdftex engine for Plain TeX. This is removed in order to provide better
+ support for multiple TeX engines. Only interface from ``color`` or
+ ``xcolor`` packages should be used by extensions of Sphinx latex writer.
+ (refs #3550)
+* ``Builder.env`` is not filled at instantiation
+* #3594: LaTeX: single raw directive has been considered as block level element
+* #3639: If ``html_experimental_html5_writer`` is available, epub builder use it by default.
+* ``Sphinx.add_source_parser()`` raises an error if duplicated
+
+1.6b2
+
+* #3345: Replace the custom smartypants code with Docutils' smart_quotes.
+ Thanks to Dmitry Shachnev, and to Günter Milde at Docutils.
+
+1.6b3
+
+* LaTeX package ``eqparbox`` is not used and not loaded by Sphinx anymore
+* LaTeX package ``multirow`` is not used and not loaded by Sphinx anymore
+* Add line numbers to citation data in std domain
+
+1.6 final
+
+* LaTeX package ``threeparttable`` is not used and not loaded by Sphinx
+ anymore (refs #3686, #3532, #3377)
+
+Features removed
+----------------
+
+* Configuration variables
+
+ - epub3_contributor
+ - epub3_description
+ - epub3_page_progression_direction
+ - html_translator_class
+ - html_use_modindex
+ - latex_font_size
+ - latex_paper_size
+ - latex_preamble
+ - latex_use_modindex
+ - latex_use_parts
+
+* ``termsep`` node
+* defindex.html template
+* LDML format support in `today`, `today_fmt` and `html_last_updated_fmt`
+* ``:inline:`` option for the directives of sphinx.ext.graphviz extension
+* sphinx.ext.pngmath extension
+* ``sphinx.util.compat.make_admonition()``
+
+Features added
+--------------
+
+1.6b1
+
+* #3136: Add ``:name:`` option to the directives in ``sphinx.ext.graphviz``
+* #2336: Add ``imported_members`` option to ``sphinx-autogen`` command to document
+ imported members.
+* C++, add ``:tparam-line-spec:`` option to templated declarations.
+ When specified, each template parameter will be rendered on a separate line.
+* #3359: Allow sphinx.js in a user locale dir to override sphinx.js from Sphinx
+* #3303: Add ``:pyversion:`` option to the doctest directive.
+* #3378: (latex) support for ``:widths:`` option of table directives
+ (refs: #3379, #3381)
+* #3402: Allow to suppress "download file not readable" warnings using
+ :confval:`suppress_warnings`.
+* #3377: latex: Add support for Docutils 0.13 ``:align:`` option for tables
+ (but does not implement text flow around table).
+* latex: footnotes from inside tables are hyperlinked (except from captions or
+ headers) (refs: #3422)
+* Emit warning if over dedent has detected on ``literalinclude`` directive
+ (refs: #3416)
+* Use for LuaLaTeX same default settings as for XeLaTeX (i.e. ``fontspec`` and
+ ``polyglossia``). (refs: #3070, #3466)
+* Make ``'extraclassoptions'`` key of ``latex_elements`` public (refs #3480)
+* #3463: Add warning messages for required EPUB3 metadata. Add default value to
+ ``epub_description`` to avoid warning like other settings.
+* #3476: setuptools: Support multiple builders
+* latex: merged cells in LaTeX tables allow code-blocks, lists, blockquotes...
+ as do normal cells (refs: #3435)
+* HTML builder uses experimental HTML5 writer if ``html_experimental_html5_writer`` is True
+ and docutils 0.13 or later is installed.
+* LaTeX macros to customize space before and after tables in PDF output (refs #3504)
+* #3348: Show decorators in literalinclude and viewcode directives
+* #3108: Show warning if :start-at: and other literalinclude options does not
+ match to the text
+* #3609: Allow to suppress "duplicate citation" warnings using
+ ``suppress_warnings``
+* #2803: Discovery of builders by entry point
+* #1764, #1676: Allow setting 'rel' and 'title' attributes for stylesheets
+* #3589: Support remote images on non-HTML builders
+* #3589: Support images in Data URI on non-HTML builders
+* #2961: improve :confval:`autodoc_mock_imports`. Now the config value only
+ requires to declare the top-level modules that should be mocked.
+ Thanks to Robin Jarry.
+* #3449: On py3, autodoc use inspect.signature for more accurate signature
+ calculation. Thanks to Nathaniel J. Smith.
+* #3641: Epub theme supports HTML structures that are generated by HTML5 writer.
+* #3644 autodoc uses inspect instead of checking types. Thanks to
+ Jeroen Demeyer.
+* Add a new extension; ``sphinx.ext.imgconverter``. It converts images in the
+ document to appropriate format for builders
+* latex: Use templates to render tables (refs #3389, 2a37b0e)
+
+1.6b2
+
+* ``LATEXMKOPTS`` variable for the Makefile in ``$BUILDDIR/latex`` to pass
+ options to ``latexmk`` when executing ``make latexpdf`` (refs #3695, #3720)
+* Add a new event `env-check-consistency` to check consistency to extensions
+* Add `Domain.check_consistency()` to check consistency
+
+Bugs fixed
+----------
+
+1.6b1
+
+* ``literalinclude`` directive expands tabs after dedent-ing (refs: #3416)
+* #1574: Paragraphs in table cell doesn't work in Latex output
+* #3288: Table with merged headers not wrapping text
+* #3491: Inconsistent vertical space around table and longtable in PDF
+* #3506: Depart functions for all admonitions in HTML writer now properly pass ``node`` to ``depart_admonition``.
+* #2693: Sphinx latex style file wrongly inhibits colours for section headings
+ for latex+dvi(ps,pdf,pdfmx)
+* C++, properly look up ``any`` references.
+* #3624: sphinx.ext.intersphinx couldn't load inventories compressed with gzip
+* #3551: PDF information dictionary is lacking author and title data
+* #3351: intersphinx does not refers context like ``py:module``, ``py:class``
+ and so on.
+* Fail to load template file if the parent template is archived
+
+1.6b2
+
+* #3661: sphinx-build crashes on parallel build
+* #3669: gettext builder fails with "ValueError: substring not found"
+* #3660: Sphinx always depends on sphinxcontrib-websupport and its dependencies
+* #3472: smart quotes getting wrong in latex (at least with list of strings via
+ autoattribute) (refs: #3345, #3666)
+
+1.6b3
+
+* #3588: No compact (p tag) html output in the i18n document build even when
+ :confval:`html_compact_lists` is True.
+* The ``make latexpdf`` from 1.6b1 (for GNU/Linux and Mac OS, using
+ ``latexmk``) aborted earlier in case of LaTeX errors than was the case with
+ 1.5 series, due to hard-coded usage of ``--halt-on-error`` option. (refs #3695)
+* #3683: sphinx.websupport module is not provided by default
+* #3683: Failed to build document if builder.css_file.insert() is called
+* #3714: viewcode extension not taking ``highlight_code='none'`` in account
+* #3698: Moving :doc: to std domain broke backwards compatibility
+* #3633: misdetect unreferenced citations
+
+1.6 final
+
+* LaTeX tables do not allow multiple paragraphs in a header cell
+* LATEXOPTS is not passed over correctly to pdflatex since 1.6b3
+* #3532: Figure or literal block captions in cells of short tables cause havoc
+ in PDF output
+* Fix: in PDF captions of tables are rendered differently whether table is of
+ longtable class or not (refs #3686)
+* #3725: Todo looks different from note in LaTeX output
+* #3479: stub-columns have no effect in LaTeX output
+* #3738: Nonsensical code in theming.py
+* #3746: PDF builds fail with latexmk 4.48 or earlier due to undefined
+ options ``-pdfxe`` and ``-pdflua``
+
+Deprecated
+----------
+
+1.6b1
+
+* ``sphinx.util.compat.Directive`` class is now deprecated. Please use instead
+ ``docutils.parsers.rst.Directive``
+* ``sphinx.util.compat.docutils_version`` is now deprecated
+* #2367: ``Sphinx.warn()``, ``Sphinx.info()`` and other logging methods are now
+ deprecated. Please use ``sphinx.util.logging`` (:ref:`logging-api`) instead.
+* #3318: ``notice`` is now deprecated as LaTeX environment name and will be
+ removed at Sphinx 1.7. Extension authors please use ``sphinxadmonition``
+ instead (as Sphinx does since 1.5.)
+* ``Sphinx.status_iterator()`` and ``Sphinx.old_status_iterator()`` is now
+ deprecated. Please use ``sphinx.util:status_iterator()`` instead.
+* ``Sphinx._directive_helper()`` is deprecated. Please use
+ ``sphinx.util.docutils.directive_helper()`` instead.
+* ``BuildEnvironment.set_warnfunc()`` is now deprecated
+* Following methods of ``BuildEnvironment`` is now deprecated.
+
+ - ``BuildEnvironment.note_toctree()``
+ - ``BuildEnvironment.get_toc_for()``
+ - ``BuildEnvironment.get_toctree_for()``
+ - ``BuildEnvironment.create_index()``
+
+ Please use ``sphinx.environment.adapters`` modules instead.
+* latex package ``footnote`` is not loaded anymore by its bundled replacement
+ ``footnotehyper-sphinx``. The redefined macros keep the same names as in the
+ original package.
+* #3429: deprecate config setting ``latex_keep_old_macro_names``. It will be
+ removed at 1.7, and already its default value has changed from ``True`` to
+ ``False``.
+* #3221: epub2 builder is deprecated
+* #3254: ``sphinx.websupport`` is now separated into independent package;
+ ``sphinxcontrib-websupport``. ``sphinx.websupport`` will be removed in
+ Sphinx-2.0.
+* #3628: ``sphinx_themes`` entry_point is deprecated. Please use
+ ``sphinx.html_themes`` instead.
+
+1.6b2
+
+* #3662: ``builder.css_files`` is deprecated. Please use ``add_stylesheet()``
+ API instead.
+
+1.6 final
+
+* LaTeX ``\sphinxstylethead`` is deprecated at 1.6 and will be removed at 1.7.
+ Please move customization into new macro ``\sphinxstyletheadfamily``.
+
+Testing
+--------
+
+1.6 final
+
+* #3458: Add ``sphinx.testing`` (experimental)
+
+Release 1.6 (unreleased)
+========================
+
+* not released (because of package script error)
+
Release 1.5.6 (released May 15, 2017)
=====================================
@@ -68,6 +411,8 @@ Features added
* Support requests-2.0.0 (experimental) (refs: #3367)
* (latex) PDF page margin dimensions may be customized (refs: #3387)
+* ``literalinclude`` directive allows combination of ``:pyobject:`` and
+ ``:lines:`` options (refs: #3416)
* #3400: make-mode doesn't use subprocess on building docs
Bugs fixed
@@ -224,7 +569,7 @@ Incompatible changes
* Fix ``genindex.html``, Sphinx's document template, link address to itself to satisfy xhtml standard.
* Use epub3 builder by default. And the old epub builder is renamed to epub2.
* Fix ``epub`` and ``epub3`` builders that contained links to ``genindex`` even if ``epub_use_index = False``.
-* `html_translator_class` is now deprecated.
+* ``html_translator_class`` is now deprecated.
Use `Sphinx.set_translator()` API instead.
* Drop python 2.6 and 3.3 support
* Drop epub3 builder's ``epub3_page_progression_direction`` option (use ``epub3_writing_mode``).
@@ -244,6 +589,8 @@ Incompatible changes
The non-modified package is used.
* #3057: By default, footnote marks in latex PDF output are not preceded by a
space anymore, ``\sphinxBeforeFootnote`` allows user customization if needed.
+* LaTeX target requires that option ``hyperfootnotes`` of package ``hyperref``
+ be left unchanged to its default (i.e. ``true``) (refs: #3022)
1.5 final
@@ -394,7 +741,7 @@ Bugs fixed
* `sphinx.ext.autodoc` crashes if target code imports * from mock modules
by `autodoc_mock_imports`.
* #1953: ``Sphinx.add_node`` does not add handlers the translator installed by
- `html_translator_class`
+ ``html_translator_class``
* #1797: text builder inserts blank line on top
* #2894: quickstart main() doesn't use argv argument
* #2874: gettext builder could not extract all text under the ``only``
@@ -801,7 +1148,8 @@ Incompatible changes
``"MMMM dd, YYYY"`` is default format for `today_fmt` and `html_last_updated_fmt`.
However strftime format like ``"%B %d, %Y"`` is also supported for backward
compatibility until Sphinx-1.5. Later format will be disabled from Sphinx-1.5.
-* #2327: `latex_use_parts` is deprecated now. Use `latex_toplevel_sectioning` instead.
+* #2327: ``latex_use_parts`` is deprecated now. Use `latex_toplevel_sectioning`
+ instead.
* #2337: Use ``\url{URL}`` macro instead of ``\href{URL}{URL}`` in LaTeX writer.
* #1498: manpage writer: don't make whole of item in definition list bold if it includes strong node.
* #582: Remove hint message from quick search box for html output.
@@ -1364,7 +1712,7 @@ Features added
for the ids defined on the node. Thanks to Olivier Heurtier.
* PR#229: Allow registration of other translators. Thanks to Russell Sim.
* Add app.set_translator() API to register or override a Docutils translator
- class like `html_translator_class`.
+ class like ``html_translator_class``.
* PR#267, #1134: add 'diff' parameter to literalinclude. Thanks to Richard Wall
and WAKAYAMA shirou.
* PR#272: Added 'bizstyle' theme. Thanks to Shoji KUMAGAI.
@@ -2665,5 +3013,5 @@ Previous versions
=================
The changelog for versions before 1.0 can be found in the file ``CHANGES.old``
-in the source distribution or `at Github
+in the source distribution or `at GitHub
<https://github.com/sphinx-doc/sphinx/raw/master/CHANGES.old>`__.
... 118739 lines suppressed ...
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/sphinx.git
More information about the Python-modules-commits
mailing list