Request 947727 (accepted)

This request supersedes: request 947487 (Show diff), request 947726 (Show diff)

Overview

Request 947727 accepted

- Fix missing install_requires dependencies.
- I know it looks cool to have URLs for all Source files, but these are
files in VCS and they are inherently very unstable, so it breaks our
checks.
- Update to version 4.4.0:
* #10007: Use ``importlib_metadata`` for python-3.9 or older
* #10007: Drop ``setuptools``
* #9075: autodoc: Add a config variable :confval:`autodoc_typehints_format`
to suppress the leading module names of typehints of function signatures (ex.
``io.StringIO`` -> ``StringIO``)
* #9831: Autosummary now documents only the members specified in a module's
``__all__`` attribute if :confval:`autosummary_ignore_module_all` is set to
``False``. The default behaviour is unchanged. Autogen also now supports
this behavior with the ``--respect-module-all`` switch.
* #9555: autosummary: Improve error messages on failure to load target object
* #9800: extlinks: Emit warning if a hardcoded link is replaceable
by an extlink, suggesting a replacement.
* #9961: html: Support nested HTML elements in other HTML builders
* #10013: html: Allow to change the loading method of JS via ``loading_method``
parameter for :meth:`Sphinx.add_js_file()`
* #9551: html search: "Hide Search Matches" link removes "highlight" parameter
from URL
* #9815: html theme: Wrap sidebar components in div to allow customizing their
layout via CSS
* #9827: i18n: Sort items in glossary by translated terms
* #9899: py domain: Allows to specify cross-reference specifier (``.`` and
``~``) as ``:type:`` option
* #9894: linkcheck: add option ``linkcheck_exclude_documents`` to disable link
checking in matched documents.
* #9793: sphinx-build: Allow to use the parallel build feature in macOS on macOS
and Python3.8+
* #10055: sphinx-build: Create directories when ``-w`` option given
* #9993: std domain: Allow to refer an inline target (ex. ``_`target name```)
via :rst:role:`ref` role
* #9981: std domain: Strip value part of the option directive from general index
* #9391: texinfo: improve variable in ``samp`` role
* #9578: texinfo: Add :confval:`texinfo_cross_references` to disable cross
references for readability with standalone readers
* #9822 (and #9062), add new Intersphinx role :rst:role:`external` for explict
lookup in the external projects, without resolving to the local project.
* #9866: autodoc: doccomment for the imported class was ignored
* #9883: autodoc: doccomment for the alias to mocked object was ignored
* #9908: autodoc: debug message is shown on building document using NewTypes
with Python 3.10
* #9968: autodoc: instance variables are not shown if __init__ method has
position-only-arguments
* #9194: autodoc: types under the "typing" module are not hyperlinked
* #10009: autodoc: Crashes if target object raises an error on getting docstring
* #10058: autosummary: Imported members are not shown when
``autodoc_class_signature = 'separated'``
* #9947: i18n: topic directive having a bullet list can't be translatable
* #9878: mathjax: MathJax configuration is placed after loading MathJax itself
* #9932: napoleon: empty "returns" section is generated even if no description
* #9857: Generated RFC links use outdated base url
* #9909: HTML, prevent line-wrapping in literal text.
* #10061: html theme: Configuration values added by themes are not be able to
override from conf.py
* #10073: imgconverter: Unnecessary availablity check is called for "data" URIs
* #9925: LaTeX: prohibit also with ``'xelatex'`` line splitting at dashes of
inline and parsed literals
* #9944: LaTeX: extra vertical whitespace for some nested declarations
* #9940: LaTeX: Multi-function declaration in Python domain has cramped
vertical spacing in latexpdf output
* #10015: py domain: types under the "typing" module are not hyperlinked defined
at info-field-list
* #9390: texinfo: Do not emit labels inside footnotes
* #9413: xml: Invalid XML was generated when cross referencing python objects
* #9979: Error level messages were displayed as warning messages
* #10057: Failed to scan documents if the project is placed onto the root
directory
* #9636: code-block: ``:dedent:`` without argument did strip newlines
- Add new intersphinx mapping file: readthedocs.inv.
- Fix %fdupes.
- Remove python-Sphinx-rpmlintrc as it is not used any more.

Created by mcepl almost 3 years ago
In state accepted
Supersedes 947487 947726

Submit python-Sphinx

Comments for request 947727 0
Comments for request 947487 3

Fabian Vogt (favogt) - almost 3 years ago

Causes libnvme build failure:

[   19s] FAILED: doc/libnvme.1 
[   19s] /usr/bin/sphinx-build -b man '/home/abuild/rpmbuild/BUILD/libnvme-1.0~0/doc' '/home/abuild/rpmbuild/BUILD/libnvme-1.0~0/x86_64-suse-linux/doc'
[   19s] Traceback (most recent call last):
[   19s]   File "/usr/bin/sphinx-build", line 33, in <module>
[   19s]     sys.exit(load_entry_point('Sphinx==4.4.0', 'console_scripts', 'sphinx-build')())
[   19s]   File "/usr/bin/sphinx-build", line 25, in importlib_load_entry_point
[   19s]     return next(matches).load()
[   19s]   File "/usr/lib64/python3.8/importlib/metadata.py", line 77, in load
[   19s]     module = import_module(match.group('module'))
[   19s]   File "/usr/lib64/python3.8/importlib/__init__.py", line 127, in import_module
[   19s]     return _bootstrap._gcd_import(name[level:], package, level)
[   19s]   File "<frozen importlib._bootstrap>", line 1014, in _gcd_import
[   19s]   File "<frozen importlib._bootstrap>", line 991, in _find_and_load
[   19s]   File "<frozen importlib._bootstrap>", line 975, in _find_and_load_unlocked
[   19s]   File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
[   19s]   File "<frozen importlib._bootstrap_external>", line 843, in exec_module
[   19s]   File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
[   19s]   File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 26, in <module>
[   19s]     from sphinx.application import Sphinx
[   19s]   File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 25, in <module>
[   19s]     from docutils.parsers.rst import Directive, roles
[   19s]   File "/usr/lib/python3.8/site-packages/docutils/parsers/rst/__init__.py", line 75, in <module>
[   19s]     from docutils.parsers.rst import roles, states
[   19s]   File "/usr/lib/python3.8/site-packages/docutils/parsers/rst/roles.py", line 78, in <module>
[   19s]     from docutils.utils.code_analyzer import Lexer, LexerError
[   19s]   File "/usr/lib/python3.8/site-packages/docutils/utils/code_analyzer.py", line 11, in <module>
[   19s]     from pkg_resources import DistributionNotFound as ResourceError
[   19s]   File "/usr/lib/python3.8/site-packages/pkg_resources/__init__.py", line 3243, in <module>
[   19s]     def _initialize_master_working_set():
[   19s]   File "/usr/lib/python3.8/site-packages/pkg_resources/__init__.py", line 3226, in _call_aside
[   19s]     f(*args, **kwargs)
[   19s]   File "/usr/lib/python3.8/site-packages/pkg_resources/__init__.py", line 3255, in _initialize_master_working_set
[   19s]     working_set = WorkingSet._build_master()
[   19s]   File "/usr/lib/python3.8/site-packages/pkg_resources/__init__.py", line 568, in _build_master
[   19s]     ws.require(__requires__)
[   19s]   File "/usr/lib/python3.8/site-packages/pkg_resources/__init__.py", line 886, in require
[   19s]     needed = self.resolve(parse_requirements(requirements))
[   19s]   File "/usr/lib/python3.8/site-packages/pkg_resources/__init__.py", line 772, in resolve
[   19s]     raise DistributionNotFound(req, requirers)
[   19s] pkg_resources.DistributionNotFound: The 'importlib-metadata>=4.4' distribution was not found and is required by Sphinx