search

tikservices / django-jet2

Next Generation of django-jet (Modern responsive template for the Django admin interface with improved functionality.)
https://github.com/tiktn/django-jet2
GNU Affero General Public License v3.0
6 stars 12 forks source link

Pin sphinx to latest version 2.1.2 #13

Closed pyup-bot closed 5 years ago

pyup-bot commented 5 years ago

This PR pins sphinx to the latest release 2.1.2.

Changelog ### 2.1.2 ``` ============================== Dependencies ------------ Incompatible changes -------------------- Deprecated ---------- Features added -------------- Bugs fixed ---------- Testing -------- ``` ### 2.1.1 ``` ===================================== Incompatible changes -------------------- * 6447: autodoc: Stop to generate document for undocumented module variables Bugs fixed ---------- * 6442: LaTeX: admonitions of :rst:dir:`note` type can get separated from immediately preceding section title by pagebreak * 6448: autodoc: crashed when autodocumenting classes with ``__slots__ = None`` * 6451: autodoc: generates docs for "optional import"ed modules as variables * 6452: autosummary: crashed when generating document of properties * 6455: napoleon: docstrings for properties are not processed * 6436: napoleon: "Unknown target name" error if variable name ends with underscore * 6440: apidoc: missing blank lines between modules ``` ### 2.1.0 ``` ===================================== Incompatible changes -------------------- * Ignore filenames without file extension given to ``Builder.build_specific()`` API directly * 6230: The anchor of term in glossary directive is changed if it is consisted by non-ASCII characters * 4550: html: Centering tables by default using CSS * 6239: latex: xelatex and xeCJK are used for Chinese documents by default * ``Sphinx.add_lexer()`` now takes a Lexer class instead of instance. An instance of lexers are still supported until Sphinx-3.x. Deprecated ---------- * ``sphinx.builders.latex.LaTeXBuilder.apply_transforms()`` * ``sphinx.builders._epub_base.EpubBuilder.esc()`` * ``sphinx.directives.Acks`` * ``sphinx.directives.Author`` * ``sphinx.directives.Centered`` * ``sphinx.directives.Class`` * ``sphinx.directives.CodeBlock`` * ``sphinx.directives.Figure`` * ``sphinx.directives.HList`` * ``sphinx.directives.Highlight`` * ``sphinx.directives.Include`` * ``sphinx.directives.Index`` * ``sphinx.directives.LiteralInclude`` * ``sphinx.directives.Meta`` * ``sphinx.directives.Only`` * ``sphinx.directives.SeeAlso`` * ``sphinx.directives.TabularColumns`` * ``sphinx.directives.TocTree`` * ``sphinx.directives.VersionChange`` * ``sphinx.domains.python.PyClassmember`` * ``sphinx.domains.python.PyModulelevel`` * ``sphinx.domains.std.StandardDomain._resolve_citation_xref()`` * ``sphinx.domains.std.StandardDomain.note_citations()`` * ``sphinx.domains.std.StandardDomain.note_citation_refs()`` * ``sphinx.domains.std.StandardDomain.note_labels()`` * ``sphinx.environment.NoUri`` * ``sphinx.ext.apidoc.format_directive()`` * ``sphinx.ext.apidoc.format_heading()`` * ``sphinx.ext.apidoc.makename()`` * ``sphinx.ext.autodoc.importer.MockFinder`` * ``sphinx.ext.autodoc.importer.MockLoader`` * ``sphinx.ext.autodoc.importer.mock()`` * ``sphinx.ext.autosummary.autolink_role()`` * ``sphinx.ext.imgmath.DOC_BODY`` * ``sphinx.ext.imgmath.DOC_BODY_PREVIEW`` * ``sphinx.ext.imgmath.DOC_HEAD`` * ``sphinx.transforms.CitationReferences`` * ``sphinx.transforms.SmartQuotesSkipper`` * ``sphinx.util.docfields.DocFieldTransformer.preprocess_fieldtypes()`` * ``sphinx.util.node.find_source_node()`` * ``sphinx.util.i18n.find_catalog()`` * ``sphinx.util.i18n.find_catalog_files()`` * ``sphinx.util.i18n.find_catalog_source_files()`` For more details, see :ref:`deprecation APIs list <dev-deprecated-apis>`. Features added -------------- * Add a helper class ``sphinx.transforms.post_transforms.SphinxPostTransform`` * Add helper methods - ``PythonDomain.note_module()`` - ``PythonDomain.note_object()`` - ``SphinxDirective.set_source_info()`` * 6180: Support ``--keep-going`` with BuildDoc setup command * ``math`` directive now supports ``:class:`` option * 6310: imgmath: let :confval:`imgmath_use_preview` work also with the SVG format for images rendering inline math * todo: ``todo`` directive now supports ``:name:`` option * Enable override via environment of ``SPHINXOPTS`` and ``SPHINXBUILD`` Makefile variables (refs: 6232, 6303) * 6287: autodoc: Unable to document bound instance methods exported as module functions * 6289: autodoc: :confval:`autodoc_default_options` now supports ``imported-members`` option * 4777: autodoc: Support coroutine * 744: autodoc: Support abstractmethod * 6325: autodoc: Support attributes in __slots__. For dict-style __slots__, autodoc considers values as a docstring of the attribute * 6361: autodoc: Add :confval:`autodoc_typehints` to suppress typehints from signature * 1063: autodoc: ``automodule`` directive now handles undocumented module level variables * 6212 autosummary: Add :confval:`autosummary_imported_members` to display imported members on autosummary * 6271: ``make clean`` is catastrophically broken if building into '.' * 6363: Support ``%O%`` environment variable in make.bat * 4777: py domain: Add ``:async:`` option to :rst:dir:`py:function` directive * py domain: Add new options to :rst:dir:`py:method` directive - ``:abstractmethod:`` - ``:async:`` - ``:classmethod:`` - ``:property:`` - ``:staticmethod:`` * rst domain: Add :rst:dir:`directive:option` directive to describe the option for directive * 6306: html: Add a label to search form for accessability purposes * 4390: html: Consistent and semantic CSS for signatures * 6358: The ``rawsource`` property of ``production`` nodes now contains the full production rule * 6373: autosectionlabel: Allow suppression of warnings * coverage: Support a new ``coverage_ignore_pyobjects`` option * 6239: latex: Support to build Chinese documents Bugs fixed ---------- * 6230: Inappropriate node_id has been generated by glossary directive if term is consisted by non-ASCII characters * 6213: ifconfig: contents after headings are not shown * commented term in glossary directive is wrongly recognized * 6299: rst domain: rst:directive directive generates waste space * 6379: py domain: Module index (py-modindex.html) has duplicate titles * 6331: man: invalid output when doctest follows rubric * 6351: "Hyperlink target is not referenced" message is shown even if referenced * 6165: autodoc: ``tab_width`` setting of docutils has been ignored * 6347: autodoc: crashes with a plain Tuple on Python 3.6 and 3.5 * 6311: autosummary: autosummary table gets confused by complex type hints * 6350: autosummary: confused by an argument having some kind of default value * Generated Makefiles lack a final EOL (refs: 6232) * 6375: extlinks: Cannot escape angle brackets in link caption * 6378: linkcheck: Send commonly used User-Agent * 6387: html search: failed to search document with haiku and scrolls themes * 6408: html search: Fix the ranking of search results * 6406: Wrong year is returned for ``SOURCE_DATE_EPOCH`` * 6402: image directive crashes by unknown image format * 6286: C++, allow 8 and 9 in hexadecimal integer literals. * 6305: Fix the string in quickstart for 'path' argument of parser * LaTeX: Figures in admonitions produced errors (refs: 6364) ``` ### 2.0.1 ``` ===================================== Bugs fixed ---------- * LaTeX: some system labels are not translated * RemovedInSphinx30Warning is marked as pending * deprecation warnings are not emitted - sphinx.application.CONFIG_FILENAME - sphinx.builders.htmlhelp - :confval:`viewcode_import` * 6208: C++, properly parse full xrefs that happen to have a short xref as prefix * 6220, 6225: napoleon: AttributeError is raised for raised section having references * 6245: circular import error on importing SerializingHTMLBuilder * 6243: LaTeX: 'releasename' setting for latex_elements is ignored * 6244: html: Search function is broken with 3rd party themes * 6263: html: HTML5Translator crashed with invalid field node * 6262: html theme: The style of field lists has changed in bizstyle theme ``` ### 2.0.0 ``` * 6196: py domain: unexpected prefix is generated Testing -------- ``` ### 2.0.0b2 ``` * Add a helper function: ``sphinx.testing.restructuredtext.parse()`` ``` ### 2.0.0b1 ``` * Stop to use ``SPHINX_TEST_TEMPDIR`` envvar ``` ### 1.8.5 ``` ===================================== Bugs fixed ---------- * LaTeX: Remove extraneous space after author names on PDF title page (refs: 6004) * 6026: LaTeX: A cross reference to definition list does not work * 6046: LaTeX: ``TypeError`` is raised when invalid latex_elements given * 6067: LaTeX: images having a target are concatenated to next line * 6067: LaTeX: images having a target are not aligned even if specified * 6149: LaTeX: ``:index:`` role in titles causes ``Use of \icentercr doesn't match its definition`` error on latexpdf build * 6019: imgconverter: Including multipage PDF fails * 6047: autodoc: ``autofunction`` emits a warning for method objects * 6028: graphviz: Ensure the graphviz filenames are reproducible * 6068: doctest: ``skipif`` option may remove the code block from documentation * 6136: ``:name:`` option for ``math`` directive causes a crash * 6139: intersphinx: ValueError on failure reporting * 6135: changes: Fix UnboundLocalError when any module found * 3859: manpage: code-block captions are not displayed correctly ``` ### 1.8.4 ``` ===================================== Bugs fixed ---------- * 3707: latex: no bold checkmark (✔) available. * 5605: with the documentation language set to Chinese, English words could not be searched. * 5889: LaTeX: user ``numfig_format`` is stripped of spaces and may cause build failure * C++, fix hyperlinks for declarations involving east cv-qualifiers. * 5755: C++, fix duplicate declaration error on function templates with constraints in the return type. * C++, parse unary right fold expressions and binary fold expressions. * pycode could not handle egg files on windows * 5928: KeyError: 'DOCUTILSCONFIG' when running build * 5936: LaTeX: PDF build broken by inclusion of image taller than page height in an admonition * 5231: "make html" does not read and build "po" files in "locale" dir * 5954: ``:scale:`` image option may break PDF build if image in an admonition * 5966: mathjax has not been loaded on incremental build * 5960: LaTeX: modified PDF layout since September 2018 TeXLive update of :file:`parskip.sty` * 5948: LaTeX: duplicated labels are generated for sections * 5958: versionadded directive causes crash with Python 3.5.0 * 5995: autodoc: autodoc_mock_imports conflict with metaclass on Python 3.7 * 5871: texinfo: a section title ``.`` is not allowed ``` ### 1.8.3 ``` ===================================== Features added -------------- * LaTeX: it is possible to insert custom material to appear on back of title page, see discussion of ``'maketitle'`` key of :confval:`latex_elements` (``'manual'`` docclass only) Bugs fixed ---------- * 5725: mathjax: Use CDN URL for "latest" version by default * 5460: html search does not work with some 3rd party themes * 5520: LaTeX, caption package incompatibility since Sphinx 1.6 * 5614: autodoc: incremental build is broken when builtin modules are imported * 5627: qthelp: index.html missing in QtHelp * 5659: linkcheck: crashes for a hyperlink containing multibyte character * 5754: DOC: Fix some mistakes in :doc:`/latex` * 5810: LaTeX: sphinxVerbatim requires explicit "hllines" set-up since 1.6.6 (refs: 1238) * 5636: C++, fix parsing of floating point literals. * 5496 (again): C++, fix assertion in partial builds with duplicates. * 5724: quickstart: sphinx-quickstart fails when $LC_ALL is empty * 1956: Default conf.py is not PEP8-compliant * 5849: LaTeX: document class ``\maketitle`` is overwritten with no possibility to use original meaning in place of Sphinx custom one * 5834: apidoc: wrong help for ``--tocfile`` * 5800: todo: crashed if todo is defined in TextElement * 5846: htmlhelp: convert hex escaping to decimal escaping in .hhc/.hhk files * htmlhelp: broken .hhk file generated when title contains a double quote ``` ### 1.8.2 ``` ===================================== Incompatible changes -------------------- * 5497: Do not include MathJax.js and jsmath.js unless it is really needed Features added -------------- * 5471: Show appropriate deprecation warnings Bugs fixed ---------- * 5490: latex: enumerated list causes a crash with recommonmark * 5492: sphinx-build fails to build docs w/ Python < 3.5.2 * 3704: latex: wrong ``\label`` positioning for figures with a legend * 5496: C++, fix assertion when a symbol is declared more than twice. * 5493: gettext: crashed with broken template * 5495: csv-table directive with file option in included file is broken (refs: 4821) * 5498: autodoc: unable to find type hints for a ``functools.partial`` * 5480: autodoc: unable to find type hints for unresolvable Forward references * 5419: incompatible math_block node has been generated * 5548: Fix ensuredir() in case of pre-existing file * 5549: graphviz Correctly deal with non-existing static dir * 3002: i18n: multiple footnote_references referring same footnote cause duplicated node_ids * 5563: latex: footnote_references generated by extension causes a LaTeX builder crash * 5561: make all-pdf fails with old xindy version * 5557: quickstart: --no-batchfile isn't honored * 3080: texinfo: multiline rubrics are broken * 3080: texinfo: multiline citations are broken ``` ### 1.8.1 ``` ===================================== Incompatible changes -------------------- * LaTeX ``\pagestyle`` commands have been moved to the LaTeX template. No changes in PDF, except possibly if ``\sphinxtableofcontents``, which contained them, had been customized in :file:`conf.py`. (refs: 5455) Bugs fixed ---------- * 5418: Incorrect default path for sphinx-build -d/doctrees files * 5421: autodoc emits deprecation warning for :confval:`autodoc_default_flags` * 5422: lambda object causes PicklingError on storing environment * 5417: Sphinx fails to build with syntax error in Python 2.7.5 * 4911: add latexpdf to make.bat for non make-mode * 5436: Autodoc does not work with enum subclasses with properties/methods * 5437: autodoc: crashed on modules importing eggs * 5433: latex: ImportError: cannot import name 'DEFAULT_SETTINGS' * 5431: autodoc: ``autofunction`` emits a warning for callable objects * 5457: Fix TypeError in error message when override is prohibited * 5453: PDF builds of 'howto' documents have no page numbers * 5463: mathbase: math_role and MathDirective was disappeared in 1.8.0 * 5454: latex: Index has disappeared from PDF for Japanese documents * 5432: py domain: ``:type:`` field can't process ``:term:`` references * 5426: py domain: TypeError has been raised for class attribute ``` ### 1.8.0 ``` ===================================== Dependencies ------------ ``` ### 1.8.0b2 ``` * html: search box overrides to other elements if scrolled * i18n: warnings for translation catalogs have wrong line numbers (refs: 5321) * 5325: latex: cross references has been broken by multiply labeled objects * C++, fixes for symbol addition and lookup. Lookup should no longer break in partial builds. See also 5337. * 5348: download reference to remote file is not displayed * 5282: html theme: ``pygments_style`` of theme was overridden by ``conf.py`` by default * 4379: toctree shows confusing warning when document is excluded * 2401: autodoc: ``:members:`` causes ``:special-members:`` not to be shown * autodoc: ImportError is replaced by AttributeError for deeper module * 2720, 4034: Incorrect links with ``:download:``, duplicate names, and parallel builds * 5290: autodoc: failed to analyze source code in egg package * 5399: Sphinx crashes if unknown po file exists ``` ### 1.8.0b1 ``` * 5083: Fix wrong make.bat option for internationalization. * 5115: napoleon: add admonitions added by 4613 to the docs. ``` ### 1.7.9 ``` ===================================== Features added -------------- * 5359: Make generated texinfo files reproducible by sorting the anchors Bugs fixed ---------- * 5361: crashed on incremental build if document uses include directive ``` ### 1.7.8 ``` ===================================== Incompatible changes -------------------- * The type of ``env.included`` has been changed to dict of set Bugs fixed ---------- * 5320: intersphinx: crashed if invalid url given * 5326: manpage: crashed when invalid docname is specified as ``man_pages`` * 5322: autodoc: ``Any`` typehint causes formatting error * 5327: "document isn't included in any toctree" warning on rebuild with generated files * 5335: quickstart: escape sequence has been displayed with MacPorts' python ``` ### 1.7.7 ``` ===================================== Bugs fixed ---------- * 5198: document not in toctree warning when including files only for parallel builds * LaTeX: reduce "Token not allowed in a PDF string" hyperref warnings in latex console output (refs: 5236) * LaTeX: suppress "remreset Warning: The remreset package is obsolete" in latex console output with recent LaTeX (refs: 5237) * 5234: PDF output: usage of PAPER environment variable is broken since Sphinx 1.5 * LaTeX: fix the :confval:`latex_engine` documentation regarding Latin Modern font with XeLaTeX/LuaLateX (refs: 5251) * 5280: autodoc: Fix wrong type annotations for complex typing * autodoc: Optional types are wrongly rendered * 5291: autodoc crashed by ForwardRef types * 5211: autodoc: No docs generated for functools.partial functions * 5306: autodoc: ``getargspec()`` raises NameError for invalid typehints * 5298: imgmath: math_number_all causes equations to have two numbers in html * 5294: sphinx-quickstart blank prompts in PowerShell ``` ### 1.7.6 ``` ===================================== Bugs fixed ---------- * 5037: LaTeX ``\sphinxupquote{}`` breaks in Russian * sphinx.testing uses deprecated pytest API; ``Node.get_marker(name)`` * 5016: crashed when recommonmark.AutoStrictify is enabled * 5022: latex: crashed with docutils package provided by Debian/Ubuntu * 5009: latex: a label for table is vanished if table does not have a caption * 5048: crashed with numbered toctree * 2410: C, render empty argument lists for macros. * C++, fix lookup of full template specializations with no template arguments. * 4667: C++, fix assertion on missing references in global scope when using intersphinx. Thanks to Alan M. Carroll. * 5019: autodoc: crashed by Form Feed Character * 5032: autodoc: loses the first staticmethod parameter for old styled classes * 5036: quickstart: Typing Ctrl-U clears the whole of line * 5066: html: "relations" sidebar is not shown by default * 5091: latex: curly braces in index entries are not handled correctly * 5070: epub: Wrong internal href fragment links * 5104: apidoc: Interface of ``sphinx.apidoc:main()`` has changed * 4272: PDF builds of French projects have issues with XeTeX * 5076: napoleon raises RuntimeError with python 3.7 * 5125: sphinx-build: Interface of ``sphinx:main()`` has changed * sphinx-build: ``sphinx.cmd.build.main()`` refers ``sys.argv`` instead of given argument * 5146: autosummary: warning is emitted when the first line of docstring ends with literal notation * autosummary: warnings of autosummary indicates wrong location (refs: 5146) * 5143: autodoc: crashed on inspecting dict like object which does not support sorting * 5139: autodoc: Enum argument missing if it shares value with another * 4946: py domain: rtype field could not handle "None" as a type * 5176: LaTeX: indexing of terms containing `, ``!``, or ``"`` fails * 5161: html: crashes if copying static files are failed * 5167: autodoc: Fix formatting type annotations for tuples with more than two arguments * 3329: i18n: crashed by auto-symbol footnote references * 5158: autosummary: module summary has been broken when it starts with heading ``` ### 1.7.5 ``` ===================================== Bugs fixed ---------- * 4924: html search: Upper characters problem in any other languages * 4932: apidoc: some subpackage is ignored if sibling subpackage contains a module starting with underscore * 4863, 4938, 4939: i18n doesn't handle correctly node.title as used for contents, topic, admonition, table and section. * 4913: i18n: literal blocks in bullet list are not translated * 4962: C++, raised TypeError on duplicate declaration. * 4825: C++, properly parse expr roles and give better error messages when (escaped) line breaks are present. * C++, properly use ``desc_addname`` nodes for prefixes of names. * C++, parse pack expansions in function calls. * 4915, 4916: links on search page are broken when using dirhtml builder * 4969: autodoc: constructor method should not have return annotation * latex: deeply nested enumerated list which is beginning with non-1 causes LaTeX engine crashed * 4978: latex: shorthandoff is not set up for Brazil locale * 4928: i18n: Ignore dot-directories like .git/ in LC_MESSAGES/ * 4946: py domain: type field could not handle "None" as a type * 4979: latex: Incorrect escaping of curly braces in index entries * 4956: autodoc: Failed to extract document from a subclass of the class on mocked module * 4973: latex: glossary directive adds whitespace to each item * 4980: latex: Explicit labels on code blocks are duplicated * 4919: node.asdom() crashes if toctree has :numbered: option * 4914: autodoc: Parsing error when using dataclasses without default values * 4931: autodoc: crashed when handler for autodoc-skip-member raises an error * 4931: autodoc: crashed when subclass of mocked class are processed by napoleon module * 5007: sphinx-build crashes when error log contains a "%" character ``` ### 1.7.4 ``` ===================================== Bugs fixed ---------- * 4885, 4887: domains: Crashed with duplicated objects * 4889: latex: sphinx.writers.latex causes recursive import ``` ### 1.7.3 ``` ===================================== Bugs fixed ---------- * 4769: autodoc loses the first staticmethod parameter * 4790: autosummary: too wide two column tables in PDF builds * 4795: Latex customization via ``_templates/longtable.tex_t`` is broken * 4789: imgconverter: confused by convert.exe of Windows * 4783: On windows, Sphinx crashed when drives of srcdir and outdir are different * 4812: autodoc ignores type annotated variables * 4817: wrong URLs on warning messages * 4784: latex: :confval:`latex_show_urls` assigns incorrect footnote numbers if hyperlinks exists inside substitutions * 4837: latex with class memoir Error: Font command ``\sf`` is not supported * 4803: latex: too slow in proportion to number of auto numbered footnotes * 4838: htmlhelp: The entries in .hhp file is not ordered * toctree directive tries to glob for URL having query_string * 4871: html search: Upper characters problem in German * 4717: latex: Compilation for German docs failed with LuaLaTeX and XeLaTeX * 4459: duplicated labels detector does not work well in parallel build * 4878: Crashed with extension which returns invalid metadata ``` ### 1.7.2 ``` ===================================== Incompatible changes -------------------- * 4520: apidoc: folders with an empty __init__.py are no longer excluded from TOC Bugs fixed ---------- * 4669: sphinx.build_main and sphinx.make_main throw NameError * 4685: autosummary emits meaningless warnings * autodoc: crashed when invalid options given * pydomain: always strip parenthesis if empty (refs: 1042) * 4689: autosummary: unexpectedly strips docstrings containing "i.e." * 4701: viewcode: Misplaced ``<div>`` in viewcode html output * 4444: Don't require numfig to use :numref: on sections * 4727: Option clash for package textcomp * 4725: Sphinx does not work with python 3.5.0 and 3.5.1 * 4716: Generation PDF file with TexLive on Windows, file not found error * 4574: vertical space before equation in latex * 4720: message when an image is mismatched for builder is not clear * 4655, 4684: Incomplete localization strings in Polish and Chinese * 2286: Sphinx crashes when error is happens in rendering HTML pages * 4688: Error to download remote images having long URL * 4754: sphinx/pycode/__init__.py raises AttributeError * 1435: qthelp builder should htmlescape keywords * epub: Fix docTitle elements of toc.ncx is not escaped * 4520: apidoc: Subpackage not in toc (introduced in 1.6.6) now fixed * 4767: html: search highlighting breaks mathjax equations ``` ### 1.7.1 ``` ===================================== Deprecated ---------- * 4623: ``sphinx.build_main()`` is deprecated. * autosummary: The interface of ``sphinx.ext.autosummary.get_documenter()`` has been changed (Since 1.7.0) * 4664: ``sphinx.ext.intersphinx.debug()`` is deprecated. For more details, see `deprecation APIs list <http://www.sphinx-doc.org/en/master/extdev/index.htmldeprecated-apis>`_ Bugs fixed ---------- * 4608: epub: Invalid meta tag is generated * 4260: autodoc: keyword only argument separator is not disappeared if it is appeared at top of the argument list * 4622: epub: :confval:`epub_scheme` does not effect to content.opf * 4627: graphviz: Fit graphviz images to page * 4617: quickstart: PROJECT_DIR argument is required * 4623: sphinx.build_main no longer exists in 1.7.0 * 4615: The argument of ``sphinx.build`` has been changed in 1.7.0 * autosummary: The interface of ``sphinx.ext.autosummary.get_documenter()`` has been changed * 4630: Have order on msgids in sphinx.pot deterministic * 4563: autosummary: Incorrect end of line punctuation detection * 4577: Enumerated sublists with explicit start with wrong number * 4641: A external link in TOC cannot contain "?" with ``:glob:`` option * C++, add missing parsing of explicit casts and typeid in expression parsing. * C++, add missing parsing of ``this`` in expression parsing. * 4655: Fix incomplete localization strings in Polish * 4653: Fix error reporting for parameterless ImportErrors * 4664: Reading objects.inv fails again * 4662: ``any`` refs with ``term`` targets crash when an ambiguity is encountered ``` ### 1.7.0 ``` ===================================== Dependencies ------------ ``` ### 1.7.0b3 ``` * 4019: inheritance_diagram AttributeError stopping make process * 4531: autosummary: methods are not treated as attributes * 4538: autodoc: ``sphinx.ext.autodoc.Options`` has been moved * 4539: autodoc emits warnings for partialmethods * 4223: doctest: failing tests reported in wrong file, at wrong line * i18n: message catalogs are not compiled if specific filenames are given for ``sphinx-build`` as arguments (refs: 4560) * 4027: sphinx.ext.autosectionlabel now expects labels to be the same as they are in the raw source; no smart quotes, nothig fancy. * 4581: apidoc: Excluded modules still included Testing -------- ``` ### 1.7.0b2 ``` * 4415: autodoc classifies inherited classmethods as regular methods * 4415: autodoc classifies inherited staticmethods as regular methods * 4472: DOCUMENTATION_OPTIONS is not defined * 4491: autodoc: prefer _MockImporter over other importers in sys.meta_path * 4490: autodoc: type annotation is broken with python 3.7.0a4+ * utils package is no longer installed * 3952: apidoc: module header is too escaped * 4275: Formats accepted by sphinx.util.i18n.format_date are limited * 4493: recommonmark raises AttributeError if AutoStructify enabled * 4209: intersphinx: In link title, "v" should be optional if target has no version * 4230: slowdown in writing pages with sphinx 1.6 * 4522: epub: document is not rebuilt even if config changed ``` ### 1.7.0b1 ``` * Add support for docutils 0.14 * Add tests for the ``sphinx.ext.inheritance_diagram`` extension. ``` ### 1.6.7 ``` ===================================== Bugs fixed ---------- * 1922: html search: Upper characters problem in French * 4412: Updated jQuery version from 3.1.0 to 3.2.1 * 4438: math: math with labels with whitespace cause html error * 2437: make full reference for classes, aliased with "alias of" * 4434: pure numbers as link targets produce warning * 4477: Build fails after building specific files * 4449: apidoc: include "empty" packages that contain modules * 3917: citation labels are transformed to ellipsis * 4501: graphviz: epub3 validation error caused if graph is not clickable * 4514: graphviz: workaround for wrong map ID which graphviz generates * 4525: autosectionlabel does not support parallel build * 3953: Do not raise warning when there is a working intersphinx inventory * 4487: math: ValueError is raised on parallel build. Thanks to jschueller. * 2372: autosummary: invalid signatures are shown for type annotated functions * 3942: html: table is not aligned to center even if ``:align: center`` ``` ### 1.6.6 ``` ===================================== Features added -------------- * 4181: autodoc: Sort dictionary keys when possible * ``VerbatimHighlightColor`` is a new :ref:`LaTeX 'sphinxsetup' <latexsphinxsetup>` key (refs: 4285) * Easier customizability of LaTeX macros involved in rendering of code-blocks * Show traceback if conf.py raises an exception (refs: 4369) * Add :confval:`smartquotes` to disable smart quotes through ``conf.py`` (refs: 3967) * Add :confval:`smartquotes_action` and :confval:`smartquotes_excludes` (refs: 4142, 4357) Bugs fixed ---------- * 4334: sphinx-apidoc: Don't generate references to non-existing files in TOC * 4206: latex: reST label between paragraphs loses paragraph break * 4231: html: Apply fixFirefoxAnchorBug only under Firefox * 4221: napoleon depends on autodoc, but users need to load it manually * 2298: automodule fails to document a class attribute * 4099: C++: properly link class reference to class from inside constructor * 4267: PDF build broken by Unicode U+2116 NUMERO SIGN character * 4249: PDF output: Pygments error highlighting increases line spacing in code blocks * 1238: Support ``:emphasize-lines:`` in PDF output * 4279: Sphinx crashes with pickling error when run with multiple processes and remote image * 1421: Respect the quiet flag in sphinx-quickstart * 4281: Race conditions when creating output directory * 4315: For PDF 'howto' documents, ``latex_toplevel_sectioning='part'`` generates ``\chapter`` commands * 4214: Two todolist directives break sphinx-1.6.5 * Fix links to external option docs with intersphinx (refs: 3769) * 4091: Private members not documented without :undoc-members: ``` ### 1.6.5 ``` ===================================== Features added -------------- * 4107: Make searchtools.js compatible with pre-Sphinx1.5 templates * 4112: Don't override the smart_quotes setting if it was already set * 4125: Display reference texts of original and translated passages on i18n warning message * 4147: Include the exception when logging PO/MO file read/write Bugs fixed ---------- * 4085: Failed PDF build from image in parsed-literal using ``:align:`` option * 4100: Remove debug print from autodoc extension * 3987: Changing theme from alabaster causes HTML build to fail * 4096: C++, don't crash when using the wrong role type. Thanks to mitya57. * 4070, 4111: crashes when the warning message contains format strings (again) * 4108: Search word highlighting breaks SVG images * 3692: Unable to build HTML if writing .buildinfo failed * 4152: HTML writer crashes if a field list is placed on top of the document * 4063: Sphinx crashes when labeling directive ``.. todolist::`` * 4134: [doc] :file:`docutils.conf` is not documented explicitly * 4169: Chinese language doesn't trigger Chinese search automatically * 1020: ext.todo todolist not linking to the page in pdflatex * 3965: New quickstart generates wrong SPHINXBUILD in Makefile * 3739: ``:module:`` option is ignored at content of pyobjects * 4149: Documentation: Help choosing :confval:`latex_engine` * 4090: [doc] :confval:`latex_additional_files` with extra LaTeX macros should not use ``.tex`` extension * Failed to convert reST parser error to warning (refs: 4132) ``` ### 1.6.4 ``` ===================================== Features added -------------- * 3926: Add ``autodoc_warningiserror`` to suppress the behavior of ``-W`` option during importing target modules on autodoc Bugs fixed ---------- * 3924: docname lost after dynamically parsing RST in extension * 3946: Typo in sphinx.sty (this was a bug with no effect in default context) * :pep: and :rfc: does not supports ``default-role`` directive (refs: 3960) * 3960: default_role = 'guilabel' not functioning * Missing ``texinputs_win/Makefile`` to be used in latexpdf builder on windows. * 4026: nature: Fix macOS Safari scrollbar color * 3877: Fix for C++ multiline signatures. * 4006: Fix crash on parallel build * 3969: private instance attributes causes AttributeError * 4041: C++, remove extra name linking in function pointers. * 4038: C, add missing documentation of ``member`` role. * 4044: An empty multicolumn cell causes extra row height in PDF output * 4049: Fix typo in output of sphinx-build -h * 4062: hashlib.sha1() must take bytes, not unicode on Python 3 * Avoid indent after index entries in latex (refs: 4066) * 4070: crashes when the warning message contains format strings * 4067: Return non-zero exit status when make subprocess fails * 4055: graphviz: the :align: option does not work for SVG output * 4055: graphviz: the :align: center option does not work for latex output * 4051: ``warn()`` function for HTML theme outputs 'None' string ``` ### 1.6.3 ``` ===================================== 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 ``` ### 1.6.2 ``` ===================================== 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.org2857 <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 ``` ### 1.6.1 ``` ===================================== Dependencies ------------ ``` ### 1.6 ``` * LDML format support in i18n feature * ``sphinx.addnodes.termsep`` * Some functions and classes in ``sphinx.util.pycompat``: ``zip_longest``, ``product``, ``all``, ``any``, ``next``, ``open``, ``class_types``, ``base_exception``, ``relpath``, ``StringIO``, ``BytesIO``. Please use the standard library version instead; If any deprecation warning like ``RemovedInSphinxXXXWarning`` are displayed, please refer :ref:`when-deprecation-warnings-are-displayed`. Features added -------------- ``` ### 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.6b2 ``` * 3662: ``builder.css_files`` is deprecated. Please use ``add_stylesheet()`` API instead. ``` ### 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.5.6 ``` ===================================== Bugs fixed ---------- * 3614: Sphinx crashes with requests-2.5.0 * 3618: autodoc crashes with tupled arguments * 3664: No space after the bullet in items of a latex list produced by Sphinx * 3657: EPUB builder crashes if a document starting with genindex exists * 3588: No compact (p tag) html output in the i18n document build even when :confval:`html_compact_lists` is True. * 3685: AttributeError when using 3rd party domains * 3702: LaTeX writer styles figure legends with a hard-coded ``\small`` * 3708: LaTeX writer allows irc scheme * 3717: Stop enforcing that favicon's must be .ico * 3731, 3732: Protect isenumclass predicate against non-class arguments * 3320: Warning about reference target not being found for container types * Misspelled ARCHIVEPREFIX in Makefile for latex build repertory ``` ### 1.5.5 ``` ===================================== Bugs fixed ---------- * 3597: python domain raises UnboundLocalError if invalid name given * 3599: Move to new MathJax CDN ``` ### 1.5.4 ``` ===================================== Features added -------------- * 3470: Make genindex support all kinds of letters, not only Latin ones Bugs fixed ---------- * 3445: setting ``'inputenc'`` key to ``\\usepackage[utf8x]{inputenc}`` leads to failed PDF build * EPUB file has duplicated ``nav.xhtml`` link in ``content.opf`` except first time build * 3488: objects.inv has broken when ``release`` or ``version`` contain return code * 2073, 3443, 3490: gettext builder that writes pot files unless the content are same without creation date. Thanks to Yoshiki Shibukawa. * 3487: intersphinx: failed to refer options * 3496: latex longtable's last column may be much wider than its contents * 3507: wrong quotes in latex output for productionlist directive * 3533: Moving from Sphinx 1.3.1 to 1.5.3 breaks LaTeX compilation of links rendered as code * 2665, 2607: Link names in C++ docfields, and make it possible for other domains. * 3542: C++, fix parsing error of non-type template argument with template. * 3065, 3520: python domain fails to recognize nested class * 3575: Problems with pdflatex in a Turkish document built with sphinx has reappeared (refs 2997, 2397) * 3577: Fix intersphinx debug tool * A LaTeX command such as ``\\large`` inserted in the title items of :confval:`latex_documents` causes failed PDF build (refs 3551, 3567) ``` ### 1.5.3 ``` ===================================== 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 ---------- * 3370: the caption of code-block is not picked up for translation * LaTeX: :confval:`release` is not escaped (refs: 3362) * 3364: sphinx-quickstart prompts overflow on Console with 80 chars width * since 1.5, PDF's TOC and bookmarks lack an entry for general Index (refs: 3383) * 3392: ``'releasename'`` in :confval:`latex_elements` is not working * 3356: Page layout for Japanese ``'manual'`` docclass has a shorter text area * 3394: When ``'pointsize'`` is not ``10pt``, Japanese ``'manual'`` document gets wrong PDF page dimensions * 3399: quickstart: conf.py was not overwritten by template * 3366: option directive does not allow punctuations * 3410: return code in :confval:`release` breaks html search * 3427: autodoc: memory addresses are not stripped on Windows * 3428: xetex build tests fail due to fontspec v2.6 defining ``\strong`` * 3349: Result of ``IndexBuilder.load()`` is broken * 3450: &nbsp is appeared in EPUB docs * 3418: Search button is misaligned in nature and pyramid theme * 3421: Could not translate a caption of tables * 3552: linkcheck raises UnboundLocalError ``` ### 1.5.2 ``` ===================================== Incompatible changes -------------------- * Dependency requirement updates: requests 2.4.0 or above (refs: 3268, 3310) Features added -------------- * 3241: emit latex warning if buggy titlesec (ref 3210) * 3194: Refer the $MAKE environment variable to determine ``make`` command * Emit warning for nested numbered toctrees (refs: 3142) * 978: `intersphinx_mapping` also allows a list as a parameter * 3340: (LaTeX) long lines in :dudir:`parsed-literal` are wrapped like in :rst:dir:`code-block`, inline math and footnotes are fully functional. Bugs fixed ---------- * 3246: xapian search adapter crashes * 3253: In Py2 environment, building another locale with a non-captioned toctree produces ``None`` captions * 185: References to section title including raw node has broken * 3255: In Py3.4 environment, autodoc doesn't support documentation for attributes of Enum class correctly. * 3261: ``latex_use_parts`` makes sphinx crash * The warning type ``misc.highlighting_failure`` does not work * 3294: ``add_latex_package()`` make crashes non-LaTeX builders * The caption of table are rendered as invalid HTML (refs: 3287) * 3268: Sphinx crashes with requests package from Debian jessie * 3284: Sphinx crashes on parallel build with an extension which raises unserializable exception * 3315: Bibliography crashes on latex build with docclass 'memoir' * 3328: Could not refer rubric implicitly * 3329: emit warnings if po file is invalid and can't read it. Also writing mo * 3337: Ugly rendering of definition list term's classifier * 3335: gettext does not extract field_name of a field in a field_list * 2952: C++, fix refs to operator() functions. * Fix Unicode super- and subscript digits in :rst:dir:`code-block` and parsed-literal LaTeX output (ref 3342) * LaTeX writer: leave ``"`` character inside parsed-literal as is (ref 3341) * 3234: intersphinx failed for encoded inventories * 3158: too much space after captions in PDF output * 3317: An URL in parsed-literal contents gets wrongly rendered in PDF if with hyphen * LaTeX crash if the filename of an image inserted in parsed-literal via a substitution contains an hyphen (ref 3340) * LaTeX rendering of inserted footnotes in parsed-literal is wrong (ref 3340) * Inline math in parsed-literal is not rendered well by LaTeX (ref 3340) * 3308: Parsed-literals don't wrap very long lines with pdf builder (ref 3340) * 3295: Could not import extension sphinx.builders.linkcheck * 3285: autosummary: asterisks are escaped twice * LaTeX, pass dvipdfm option to geometry package for Japanese documents (ref 3363) * Fix parselinenos() could not parse left half open range (cf. "-4") ``` ### 1.5.1 ``` ===================================== Features added -------------- * 3214: Allow to suppress "unknown mimetype" warnings from epub builder using :confval:`suppress_warnings`. Bugs fixed ---------- * 3195: Can not build in parallel * 3198: AttributeError is raised when toctree has 'self' * 3211: Remove untranslated sphinx locale catalogs (it was covered by untranslated it_IT) * 3212: HTML Builders crashes with docutils-0.13 * 3207: more latex problems with references inside parsed-literal directive (``\DUrole``) * 3205: sphinx.util.requests crashes with old pyOpenSSL (< 0.14) * 3220: KeyError when having a duplicate citation * 3200: LaTeX: xref inside desc_name not allowed * 3228: ``build_sphinx`` command crashes when missing dependency * 2469: Ignore updates of catalog files for gettext builder. Thanks to Hiroshi Ohkubo. * 3183: Randomized jump box order in generated index page. ``` ### 1.5 ``` * 3069: Even if ``'babel'`` key is set to empty string, LaTeX output contains one ``\addto\captions...`` * 3123: user ``'babel'`` key setting is not obeyed anymore * 3155: Fix JavaScript for `html_sourcelink_suffix` fails with IE and Opera * 3085: keep current directory after breaking build documentation. Thanks to Timotheus Kampik. * 3181: pLaTeX crashes with a section contains endash * 3180: latex: add stretch/shrink between successive singleline or multipleline cpp signatures (ref 3072) * 3128: globing images does not support .svgz file * 3015: fix a broken test on Windows. * 1843: Fix documentation of descriptor classes that have a custom metaclass. Thanks to Erik Bray. * 3190: util.split_docinfo fails to parse multi-line field bodies * 3024, 3037: In Python3, application.Sphinx._log crushed when the log message cannot be encoded into console encoding. Testing -------- * To simplify, sphinx uses external mock package even if unittest.mock exists. ``` ### 1.5b1 ``` * 2432: Fix unwanted * between varargs and keyword only args. Thanks to Alex Grönholm. * 3062: Failed to build PDF using 1.5a2 (undefined ``\hypersetup`` for Japanese documents since PR3030) * Better rendering of multiline signatures in html. * 777: LaTeX output "too deeply nested" (ref 3096) * Let LaTeX image inclusion obey ``scale`` before textwidth fit (ref 2865, 3059) * 3019: LaTeX fails on description of C function with arguments (ref 3083) * fix latex inline literals where ``< > -`` gobbled a space ``` ### 1.5a2 ``` * 2810: Problems with pdflatex in an Italian document * Use ``latex_elements.papersize`` to specify papersize of LaTeX in Makefile * 2988: linkcheck: retry with GET request if denied HEAD request * 2990: linkcheck raises "Can't convert 'bytes' object to str implicitly" error if linkcheck_anchors enabled * 3004: Invalid link types "top" and "up" are used * 3009: Bad rendering of parsed-literals in LaTeX since Sphinx 1.4.4 * 3000: ``option`` directive generates invalid HTML anchors * 2984: Invalid HTML has been generated if `html_split_index` enabled * 2986: themes/basic/defindex.html should be changed for html5 friendly * 2987: Invalid HTML has been generated if multiple IDs are assigned to a list * 2891: HTML search does not provide all the results * 1986: Title in PDF Output * 147: Problem with latex chapter style * 3018: LaTeX problem with page layout dimensions and chapter titles * Fix an issue with ``\pysigline`` in LaTeX style file (ref 3023) * 3038: ``sphinx.ext.math*`` raises TypeError if labels are duplicated * 3031: incompatibility with LaTeX package ``tocloft`` * 3003: literal blocks in footnotes are not supported by Latex * 3047: spacing before footnote in pdf output is not coherent and allows breaks * 3045: HTML search index creator should ignore "raw" content if now html * 3039: English stemmer returns wrong word if the word is capitalized * Fix make-mode Makefile template (ref 3056, 2936) ``` ### 1.5a1 ``` * 2707: (latex) the column width is badly computed for tabular * 2799: Sphinx installs roles and directives automatically on importing sphinx module. Now Sphinx installs them on running application. * `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`` * 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`` directives * 2485: autosummary crashes with multiple source_suffix values * 1734: Could not translate the caption of toctree directive * Could not translate the content of meta directive (ref: 1734) * 2550: external links are opened in help viewer * 2687: Running Sphinx multiple times produces 'already registered' warnings ``` ### 1.4.9 ``` ===================================== Bugs fixed ---------- * 2936: Fix doc/Makefile that can't build man because doc/man exists * 3058: Using the same 'caption' attribute in multiple 'toctree' directives results in warning / error * 3068: Allow the '=' character in the -D option of sphinx-build.py * 3074: ``add_source_parser()`` crashes in debug mode * 3135: ``sphinx.ext.autodoc`` crashes with plain Callable * 3150: Fix query word splitter in JavaScript. It behaves as same as Python's regular expression. * 3093: gettext build broken on substituted images. * 3093: gettext build broken on image node under ``note`` directive. * imgmath: crashes on showing error messages if image generation failed * 3117: LaTeX writer crashes if admonition is placed before first section title * 3164: Change search order of ``sphinx.ext.inheritance_diagram`` ``` ### 1.4.8 ``` ==================================== Bugs fixed ---------- * 2996: The wheel package of Sphinx got crash with ImportError ``` ### 1.4.7 ``` ==================================== Bugs fixed ---------- * 2890: Quickstart should return an error consistently on all error conditions * 2870: flatten genindex columns' heights. * 2856: Search on generated HTML site doesn't find some symbols * 2882: Fall back to a GET request on 403 status in linkcheck * 2902: jsdump.loads fails to load search index if keywords starts with underscore * 2900: Fix epub content.opf: add auto generated orphan files to spine. * 2899: Fix ``hasdoc()`` function in Jinja2 template. It will detect ``genindex``, ``search`` also. * 2901: Fix epub result: skip creating links from image tags to original image files. * 2917: inline code is hyphenated on HTML * 1462: autosummary warns for namedtuple with attribute with trailing underscore * Could not reference equations if ``:nowrap:`` option specified * 2873: code-block overflow in latex (due to commas) * 1060, 2056: sphinx.ext.intersphinx: broken links are generated if relative paths are used in `intersphinx_mapping` * 2931: code-block directive with same :caption: causes warning of duplicate target. Now `code-block` and `literalinclude` does not define hyperlink target using its caption automatically. * 2962: latex: missing label of longtable * 2968: autodoc: show-inheritance option breaks docstrings ``` ### 1.4.6 ``` ===================================== Incompatible changes -------------------- * 2867: linkcheck builder crashes with six-1.4. Now Sphinx depends on six-1.5 or later Bugs fixed ---------- * applehelp: Sphinx crashes if ``hiutil`` or ``codesign`` commands not found * Fix ``make clean`` abort issue when build dir contains regular files like ``DS_Store``. * Reduce epubcheck warnings/errors: * Fix DOCTYPE to html5 * Change extension from .html to .xhtml. * Disable search page on epub results * 2778: Fix autodoc crashes if obj.__dict__ is a property method and raises exception * Fix duplicated toc in epub3 output. * 2775: Fix failing linkcheck with servers not supporting identity encoding * 2833: Fix formatting instance annotations in ext.autodoc. * 1911: ``-D`` option of ``sphinx-build`` does not override the ``extensions`` variable * 2789: `sphinx.ext.intersphinx` generates wrong hyperlinks if the inventory is given * parsing errors for caption of code-blocks are displayed in document (ref: 2845) * 2846: ``singlehtml`` builder does not include figure numbers * 2816: Fix data from builds cluttering the ``Domain.initial_data`` class attributes ``` ### 1.4.5 ``` ===================================== Incompatible changes -------------------- * latex, inclusion of non-inline images from image directive resulted in non-coherent whitespaces depending on original image width; new behaviour by necessity differs from earlier one in some cases. (ref: 2672) * latex, use of ``\includegraphics`` to refer to Sphinx custom variant is deprecated; in future it will revert to original LaTeX macro, custom one already has alternative name ``\sphinxincludegraphics``. Features added -------------- * new config option ``latex_keep_old_macro_names``, defaults to True. If False, lets macros (for text styling) be defined only with ``\sphinx``-prefixed names * latex writer allows user customization of "shadowed" boxes (topics), via three length variables. * woff-format web font files now supported by the epub builder. Bugs fixed ---------- * jsdump fix for python 3: fixes the HTML search on python > 3 * 2676: (latex) Error with verbatim text in captions since Sphinx 1.4.4 * 2629: memoir class crashes LaTeX. Fixed by ``latex_keep_old_macro_names=False`` (ref 2675) * 2684: `sphinx.ext.intersphinx` crashes with six-1.4.1 * 2679: ``float`` package needed for ``'figure_align': 'H'`` latex option * 2671: image directive may lead to inconsistent spacing in pdf * 2705: ``toctree`` generates empty bullet_list if ``:titlesonly:`` specified * 2479: `sphinx.ext.viewcode` uses python2 highlighter by default * 2700: HtmlHelp builder has hard coded index.html * latex, since 1.4.4 inline literal text is followed by spurious space * 2722: C++, fix id generation for var/member declarations to include namespaces. * latex, images (from image directive) in lists or quoted blocks did not obey indentation (fixed together with 2671) * 2733: since Sphinx-1.4.4 ``make latexpdf`` generates lots of hyperref warnings * 2731: `sphinx.ext.autodoc` does not access propertymethods which raises any exceptions * 2666: C++, properly look up nested names involving constructors. * 2579: Could not refer a label including both spaces and colons via `sphinx.ext.intersphinx` * 2718: Sphinx crashes if the document file is not readable * 2699: hyperlinks in help HTMLs are broken if `html_file_suffix` is set * 2723: extra spaces in latex pdf output from multirow cell * 2735: latexpdf ``Underfull \hbox (badness 10000)`` warnings from title page * 2667: latex crashes if resized images appeared in section title * 2763: (html) Provide default value for required ``alt`` attribute for image tags of SVG source, required to validate and now consistent w/ other formats. ``` ### 1.4.4 ``` ===================================== Bugs fixed ---------- * 2630: latex: sphinx.sty notice environment formatting problem * 2632: Warning directives fail in quote environment latex build * 2633: Sphinx crashes with old styled indices * Fix a ``\begin{\minipage}`` typo in sphinx.sty from 1.4.2 (ref: 68becb1) * 2622: Latex produces empty pages after title and table of contents * 2640: 1.4.2 LaTeX crashes if code-block inside warning directive * Let LaTeX use straight quotes also in inline code (ref 2627) * 2351: latex crashes if enumerated lists are placed on footnotes * 2646: latex crashes if math contains twice empty lines * 2480: `sphinx.ext.autodoc`: memory addresses were shown * latex: allow code-blocks appearing inside lists and quotes at maximal nesting depth (ref 777, 2624, 2651) * 2635: Latex code directives produce inconsistent frames based on viewing resolution * 2639: Sphinx now bundles iftex.sty * Failed to build PDF with framed.sty 0.95 * Sphinx now bundles needspace.sty ``` ### 1.4.3 ``` ==================================== Bugs fixed ---------- * 2530: got "Counter too large" error on building PDF if large numbered footnotes existed in admonitions * ``width`` option of figure directive does not work if ``align`` option specified at same time (ref: 2595) * 2590: The ``inputenc`` package breaks compiling under lualatex and xelatex * 2540: date on latex front page use different font * Suppress "document isn't included in any toctree" warning if the document is included (ref: 2603) * 2614: Some tables in PDF output will end up shifted if user sets non zero \parindent in preamble * 2602: URL redirection breaks the hyperlinks generated by `sphinx.ext.intersphinx` * 2613: Show warnings if merged extensions are loaded * 2619: make sure amstext LaTeX package always loaded (ref: d657225, 488ee52, 9d82cad and 2615) * 2593: latex crashes if any figures in the table ``` ### 1.4.2 ``` ===================================== Features added -------------- * Now :confval:`suppress_warnings` accepts following configurations (ref: 2451, 2466): - ``app.add_node`` - ``app.add_directive`` - ``app.add_role`` - ``app.add_generic_role`` - ``app.add_source_parser`` - ``image.data_uri`` - ``image.nonlocal_uri`` * 2453: LaTeX writer allows page breaks in topic contents; and their horizontal extent now fits in the line width (with shadow in margin). Also warning-type admonitions allow page breaks and their vertical spacing has been made more coherent with the one for hint-type notices (ref 2446). * 2459: the framing of literal code-blocks in LaTeX output (and not only the code lines themselves) obey the indentation in lists or quoted blocks. * 2343: the long source lines in code-blocks are wrapped (without modifying the line numbering) in LaTeX output (ref 1534, 2304). Bugs fixed ---------- * 2370: the equations are slightly misaligned in LaTeX writer * 1817, 2077: suppress pep8 warnings on conf.py generated by sphinx-quickstart * 2407: building docs crash if document includes large data image URIs * 2436: Sphinx does not check version by :confval:`needs_sphinx` if loading extensions failed * 2397: Setup shorthandoff for Turkish documents * 2447: VerbatimBorderColor wrongly used also for captions of PDF * 2456: C++, fix crash related to document merging (e.g., singlehtml and Latex builders). * 2446: latex(pdf) sets local tables of contents (or more generally topic nodes) in unbreakable boxes, causes overflow at bottom * 2476: Omit MathJax markers if :nowrap: is given * 2465: latex builder fails in case no caption option is provided to toctree directive * Sphinx crashes if self referenced toctree found * 2481: spelling mistake for mecab search splitter. Thanks to Naoki Sato. * 2309: Fix could not refer "indirect hyperlink targets" by ref-role * intersphinx fails if mapping URL contains any port * 2088: intersphinx crashes if the mapping URL requires basic auth * 2304: auto line breaks in latexpdf codeblocks * 1534: Word wrap long lines in Latex verbatim blocks * 2460: too much white space on top of captioned literal blocks in PDF output * Show error reason when multiple math extensions are loaded (ref: 2499) * 2483: any figure number was not assigned if figure title contains only non text objects * 2501: Unicode subscript numbers are normalized in LaTeX * 2492: Figure directive with :figwidth: generates incorrect Latex-code * The caption of figure is always put on center even if ``:align:`` was specified * 2526: LaTeX writer crashes if the section having only images * 2522: Sphinx touches mo files under installed directory that caused permission error. * 2536: C++, fix crash when an immediately nested scope has the same name as the current scope. * 2555: Fix crash on any-references with unicode. * 2517: wrong bookmark encoding in PDF if using LuaLaTeX * 2521: generated Makefile causes BSD make crashed if sphinx-build not found * 2470: ``typing`` backport package causes autodoc errors with python 2.7 * ``sphinx.ext.intersphinx`` crashes if non-string value is used for key of `intersphinx_mapping` * 2518: `intersphinx_mapping` disallows non alphanumeric keys * 2558: unpack error on devhelp builder * 2561: Info builder crashes when a footnote contains a link * 2565: The descriptions of objects generated by ``sphinx.ext.autosummary`` overflow lines at LaTeX writer * Extend pdflatex config in sphinx.sty to subparagraphs (ref: 2551) * 2445: `rst_prolog` and `rst_epilog` affect to non reST sources * 2576: ``sphinx.ext.imgmath`` crashes if subprocess raises error * 2577: ``sphinx.ext.imgmath``: Invalid argument are passed to dvisvgm * 2556: Xapian search does not work with Python 3 * 2581: The search doesn't work if language="es" (Spanish) * 2382: Adjust spacing after abbreviations on figure numbers in LaTeX writer * 2383: The generated footnote by `latex_show_urls` overflows lines * 2497, 2552: The label of search but