doc/changes/1.7.rst
env.included has been changed to dict of setman_pagesAny typehint causes formatting errorlatex_engine documentation regarding Latin Modern
font with XeLaTeX/LuaLateX (refs: #5251)getargspec() raises NameError for invalid typehints\sphinxupquote{} breaks in RussianNode.get_marker(name)sphinx.apidoc:main() has changedsphinx:main() has changedsphinx.cmd.build.main() refers sys.argv instead of given
argumentNone" as a type@, !, or " failsdesc_addname nodes for prefixes of names.None" as a type_templates/longtable.tex_t is brokenlatex_show_urls assigns incorrect footnote numbers if
hyperlinks exists inside substitutions\sf is not supported<div> in viewcode html outputsphinx.build_main() is deprecated.sphinx.ext.autosummary.get_documenter() has
been changed (Since 1.7.0)sphinx.ext.intersphinx.debug() is deprecated.For more details, see :ref:deprecation APIs list <dev-deprecated-apis>.
epub_scheme does not effect to content.opfsphinx.build has been changed in 1.7.0sphinx.ext.autosummary.get_documenter() has
been changed:glob: optionthis in expression parsing.any refs with term targets crash when an ambiguity is
encountered1.7.0b1
packaging package1.7.0b1
--implicit-namespaces option given, not subdirectories of
given directory.keep_warnings is True. They are only emitted to stderr.autodoc_mock_imports only mocks specified modules
with their descendants. It does not mock their ancestors. If you want to
mock them, please specify the name of ancestors explicitly.body_min_width and body_max_width.exclude_patterns arguments are ignored if they are
placed just after command line options1.7.0b2
csss block to css1.7.0b1
html_sidebars is deprecated and only list
values will be accepted at 2.0.format_annotation() and formatargspec() is deprecated. Please use
sphinx.util.inspect.Signature instead.sphinx.ext.autodoc.AutodocReporter is replaced by sphinx.util.docutils. switch_source_input() and now deprecated. It will be removed in Sphinx 2.0.sphinx.ext.autodoc.add_documenter() and AutoDirective._register is now
deprecated. Please use app.add_autodocumenter() instead.AutoDirective._special_attrgetters is now deprecated. Please use
app.add_autodoc_attrgetter() instead.1.7.0b1
C++, handle decltype(auto).
#2406: C++, add proper parsing of expressions, including linking of identifiers.
C++, add a cpp:expr role for inserting inline C++ expressions or types.
C++, support explicit member instantiations with shorthand template prefix
C++, make function parameters linkable, like template params.
#3638: Allow to change a label of reference to equation using
math_eqref_format
Now :confval:suppress_warnings accepts following configurations:
ref.python (ref: #3866)#3872: Add latex key to configure literal blocks caption position in PDF output (refs #3792, #1723)
In case of missing docstring try to retrieve doc from base classes (ref: #3140)
#4023: Clarify error message when any role has more than one target.
#3973: epub: allow to override build date
#3972: epub: Sort manifest entries by filename
#4052: viewcode: Sort before highlighting module code
#1448: qthelp: Add new config value; :confval:qthelp_namespace
#4140: html themes: Make body tag inheritable
#4168: improve zh search with jieba
HTML themes can set up default sidebars through theme.conf
#3160: html: Use <kdb> to represent :kbd: role
#4212: autosummary: catch all exceptions when importing modules
#4166: Add :confval:math_numfig for equation numbering by section (refs:
#3991, #4080). Thanks to Oliver Jahn.
#4311: Let LaTeX obey :confval:numfig_secnum_depth for figures, tables, and
code-blocks
#947: autodoc now supports ignore-module-all to ignore a module's __all__
#4332: Let LaTeX obey :confval:math_numfig for equation numbering
#4093: sphinx-build creates empty directories for unknown targets/builders
Add top-classes option for the sphinx.ext.inheritance_diagram
extension to limit the scope of inheritance graphs.
#4183: doctest: :pyversion: option also follows PEP-440 specification
#4235: html: Add :confval:manpages_url to make manpage roles to hyperlinks
#3570: autodoc: Do not display 'typing.' module for type hints
#4354: sphinx-build now emits finish message. Builders can modify it through
Builder.epilog attribute
#4245: html themes: Add language to javascript vars list
#4079: html: Add notranslate class to each code-blocks, literals and maths
to let Google Translate know they are not translatable
#4137: doctest: doctest block is always highlighted as python console (pycon)
#4137: doctest: testcode block is always highlighted as python
#3998: text: Assign section numbers by default. You can control it using
:confval:text_add_secnumbers and :confval:text_secnumber_suffix
1.7.0b2
-j auto to adjust numbers of
processes automatically.1.7.0b1
Configuration variables
!html_use_smartypants!latex_keep_old_macro_namesutility methods of sphinx.application.Sphinx class
utility methods of sphinx.environment.BuildEnvironment class
epub2 builder
prefix and colorfunc parameter for warn()
sphinx.util.compat module
sphinx.util.nodes.process_only_nodes()
LaTeX environment notice, use sphinxadmonition instead
LaTeX \sphinxstylethead, use \sphinxstyletheadfamily
C++, support of function concepts. Thanks to mickk-on-cpp.
Not used and previously not documented LaTeX macros \shortversion
and \setshortversion
1.7.0b1
release is not set1.7.0b2
1.7.0b3
sphinx.ext.autodoc.Options has been movedsphinx-build as arguments (refs: #4560)1.7.0b1
sphinx.ext.inheritance_diagram extension.