Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
==4.1.2
->==4.5.0
Release Notes
sphinx-doc/sphinx
v4.5.0
Compare Source
=====================================
Incompatible changes
:rst:role:
ref
roleDeprecated
sphinx.ext.napoleon.docstring.GoogleDocstring._qualify_name()
Features added
FORCE_COLOR
andNO_COLOR
for terminal colouringextlinks_detect_hardcoded_links
to enablehardcoded links detector feature
:confval:
html_show_search_summary
to enable/disable the search summariesenable_search_shortcuts
that enables :kbd:'/' asa Quick search shortcut and :kbd:
Esc
shortcut thatremoves search highlighting.
#noqa
comment to the tail of each translation message
pep
role now generates URLs based on peps.python.orgBugs fixed
binary module
autodoc_default_options
does not supportno-value
optionunhashable object
[#named]
) that is referredmultiple times was rendered to a question mark
cpp:function
directive has big verticalspacing in Latexpdf
variables/structure members
the name is also used in the different document
style docstrings when :confval:
napoleon_use_ivar
is enabledcommand before showing help
v4.4.0
Compare Source
=====================================
Dependencies
importlib_metadata
for python-3.9 or oldersetuptools
Features added
autodoc_typehints_format
to suppress the leading module names of typehints of function signatures (ex.
io.StringIO
->StringIO
)__all__
attribute if :confval:autosummary_ignore_module_all
is set toFalse
. The default behaviour is unchanged. Autogen also now supportsthis behavior with the
--respect-module-all
switch.by an extlink, suggesting a replacement.
loading_method
parameter for :meth:
Sphinx.add_js_file()
from URL
layout via CSS
.
and~
) as:type:
optionlinkcheck_exclude_documents
to disable linkchecking in matched documents.
and Python3.8+
-w
option giventarget name```) via :rst:role:
ref` rolesamp
roletexinfo_cross_references
to disable crossreferences for readability with standalone readers
external
for explictlookup in the external projects, without resolving to the local project.
Bugs fixed
with Python 3.10
position-only-arguments
autodoc_class_signature = 'separated'
override from conf.py
'xelatex'
line splitting at dashes ofinline and parsed literals
vertical spacing in latexpdf output
at info-field-list
directory
:dedent:
without argument did strip newlinesv4.3.2
Compare Source
=====================================
Bugs fixed
specifiers.
v4.3.1
Compare Source
=====================================
Features added
:confval:
mathjax_options
Bugs fixed
decorated by functools.lru_cache
having invalid doc attribute
:confval:
autodoc_preserve_defaults
enableddocutils-0.17
of MathJax is back to "async" method again
v4.3.0
Compare Source
=====================================
Dependencies
Incompatible changes
searchindex.js
: the embedded data has changed format to allowobjects with the same name in different domains.
with more docutils nodes to allow better CSS styling.
It may break existing styling.
:py:meth:
domains.py.PyObject.get_signature_prefix
has changed toreturn a list of nodes instead of a plain string.
domains.js.JSObject.display_prefix
has been changed into a methodget_display_prefix
which now returns a list of nodesinstead of a plain string.
with more docutils nodes to allow better CSS styling.
It may break existing styling.
Deprecated
sphinx.ext.autodoc.AttributeDocumenter._datadescriptor
sphinx.writers.html.HTMLTranslator._fieldlist_row_index
sphinx.writers.html.HTMLTranslator._table_row_index
sphinx.writers.html5.HTML5Translator._fieldlist_row_index
sphinx.writers.html5.HTML5Translator._table_row_index
Features added
autodoc-process-bases
supports to inject reST snippet as abase class
retval
for :rst:dir:
c:function
and :rst:dir:c:macro
.retval
for :rst:dir:cpp:function
.gettext_allow_fuzzy_translations
to allow "fuzzy"messages for translation
add_stylesheet()
API. It will be kept untilthe Sphinx-6.0 release
intersphinx_disabled_reftypes
for disablinginterphinx resolution of cross-references that do not have an explicit
inventory specification. Specific types of cross-references can be disabled,
e.g.,
std:doc
or all cross-references in a specific domain,e.g.,
std:*
.warnings using :confval:
suppress_warnings
Bugs fixed
primary_domain
is not 'py'
:confval:
autodoc_typehints_description_target
is set to "documented" whenits info-field-list contains
:returns:
fieldgeneric class
autodoc_inherit_docstrings
does not effect tooverridden classmethods
autodoc_preserve_defaults
does not supporthexadecimal numeric
primary_domain
is not 'py'
return all of them as result instead of just one.
py:method
directive with
:property:
option:confval:
autodoc_typehints='description'
does not recognize
:class:`` optionbuild
e.g.,
proj:myFunc
, leave the inventory prefix in the unresolved text.v4.2.0
Compare Source
=====================================
Features added
3.10 or above
template variable
sphinx_version_tuple
:py:property:
directive supports:classmethod:
option to describe the class property
builddir
as an argumentBugs fixed
namespace package
class inherites the class having
_name
attributetyping
module are not displayedwell with the HEAD of 3.10
__init__()
and
__new__()
list[int]
)are not displayed well
are not removed completely
failed to fetch the content of the page
:type:
option for :rst:dir:py:property
directive doesnot create a hyperlink
function pointers.
language-highlighted
:code:
role.Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by WhiteSource Renovate. View repository job log here.