Path to this page:
Subject: CVS commit: pkgsrc/textproc/py-sphinx
From: Adam Ciarcinski
Date: 2022-01-24 19:21:18
Message id: 20220124182118.94151FB24@cvs.NetBSD.org
Log Message:
py-sphinx: updated to 4.4.0
Release 4.4.0 (released Jan 17, 2022)
=====================================
Dependencies
------------
* Use ``importlib_metadata`` for python-3.9 or older
* Drop ``setuptools``
Features added
--------------
* autodoc: Add a config variable :confval:`autodoc_typehints_format`
to suppress the leading module names of typehints of function signatures (ex.
``io.StringIO`` -> ``StringIO``)
* 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.
* autosummary: Improve error messages on failure to load target object
* extlinks: Emit warning if a hardcoded link is replaceable
by an extlink, suggesting a replacement.
* html: Support nested <kbd> HTML elements in other HTML builders
* html: Allow to change the loading method of JS via ``loading_method``
parameter for :meth:`Sphinx.add_js_file()`
* html search: "Hide Search Matches" link removes \
"highlight" parameter
from URL
* html theme: Wrap sidebar components in div to allow customizing their
layout via CSS
* i18n: Sort items in glossary by translated terms
* py domain: Allows to specify cross-reference specifier (``.`` and
``~``) as ``:type:`` option
* linkcheck: add option ``linkcheck_exclude_documents`` to disable link
checking in matched documents.
* sphinx-build: Allow to use the parallel build feature in macOS on macOS
and Python3.8+
* sphinx-build: Create directories when ``-w`` option given
* std domain: Allow to refer an inline target (ex. ``_`target name```)
via :rst:role:`ref` role
* std domain: Strip value part of the option directive from general index
* texinfo: improve variable in ``samp`` role
* texinfo: Add :confval:`texinfo_cross_references` to disable cross
references for readability with standalone readers
* add new Intersphinx role :rst:role:`external` for explict
lookup in the external projects, without resolving to the local project.
Bugs fixed
----------
* autodoc: doccomment for the imported class was ignored
* autodoc: doccomment for the alias to mocked object was ignored
* autodoc: debug message is shown on building document using NewTypes
with Python 3.10
* autodoc: instance variables are not shown if __init__ method has
position-only-arguments
* autodoc: types under the "typing" module are not hyperlinked
* autodoc: Crashes if target object raises an error on getting docstring
* autosummary: Imported members are not shown when
``autodoc_class_signature = 'separated'``
* i18n: topic directive having a bullet list can't be translatable
* mathjax: MathJax configuration is placed after loading MathJax itself
* napoleon: empty "returns" section is generated even if no description
* Generated RFC links use outdated base url
* HTML, prevent line-wrapping in literal text.
* html theme: Configuration values added by themes are not be able to
override from conf.py
* imgconverter: Unnecessary availablity check is called for "data" URIs
* LaTeX: prohibit also with ``'xelatex'`` line splitting at dashes of
inline and parsed literals
* LaTeX: extra vertical whitespace for some nested declarations
* LaTeX: Multi-function declaration in Python domain has cramped
vertical spacing in latexpdf output
* py domain: types under the "typing" module are not hyperlinked defined
at info-field-list
* texinfo: Do not emit labels inside footnotes
* xml: Invalid XML was generated when cross referencing python objects
* Error level messages were displayed as warning messages
* Failed to scan documents if the project is placed onto the root
directory
* code-block: ``:dedent:`` without argument did strip newlines
Files: