Remove unnecessary `:func: and :meth:` parentheses (#12848)

This commit is contained in:
Wei-Hsiang (Matt) Wang 2024-09-01 13:33:28 +08:00 committed by GitHub
parent bb2c4e9bac
commit e35e7b0fbe
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
7 changed files with 21 additions and 21 deletions

View File

@ -108,7 +108,7 @@ Features added
functions in source code and keep them not evaluated for readability.
* #8619: html: kbd role generates customizable HTML tags for compound keys
* #8634: html: Allow to change the order of JS/CSS via ``priority`` parameter
for :meth:`.Sphinx.add_js_file()` and :meth:`.Sphinx.add_css_file()`
for :meth:`.Sphinx.add_js_file` and :meth:`.Sphinx.add_css_file`
* #6241: html: Allow to add JS/CSS files to the specific page when an extension
calls ``app.add_js_file()`` or ``app.add_css_file()`` on
:event:`html-page-context` event

View File

@ -27,7 +27,7 @@ Features added
by an extlink, suggesting a replacement.
* #9961: html: Support nested <kbd> 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()`
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

View File

@ -145,7 +145,7 @@ Python :mod:`configparser` module) and has the following structure:
* The **pygments_dark_style** setting gives the name of a Pygments style to use
for highlighting when the CSS media query ``(prefers-color-scheme: dark)``
evaluates to true. It is injected into the page using
:meth:`~sphinx.application.Sphinx.add_css_file()`.
:meth:`~sphinx.application.Sphinx.add_css_file`.
* The **sidebars** setting gives the comma separated list of sidebar templates
for constructing sidebars. This can be overridden by the user in the

View File

@ -1447,12 +1447,12 @@ The following is a list of deprecated interfaces.
* - :meth:`!add_stylesheet`
- 1.8
- 6.0
- :meth:`~sphinx.application.Sphinx.add_css_file()`
- :meth:`~sphinx.application.Sphinx.add_css_file`
* - :meth:`!add_javascript()`
* - :meth:`!add_javascript`
- 1.8
- 4.0
- :meth:`~sphinx.application.Sphinx.add_js_file()`
- :meth:`~sphinx.application.Sphinx.add_js_file`
* - :confval:`autodoc_default_flags`
- 1.8
@ -1519,7 +1519,7 @@ The following is a list of deprecated interfaces.
* - ``sphinx.ext.mathbase.setup_math()``
- 1.8
- 3.0
- :meth:`~sphinx.application.Sphinx.add_html_math_renderer()`
- :meth:`~sphinx.application.Sphinx.add_html_math_renderer`
* - ``sphinx.ext.mathbase.is_in_section_title()``
- 1.8
@ -1700,7 +1700,7 @@ The following is a list of deprecated interfaces.
* - ``Sphinx.override_domain()``
- 1.8
- 3.0
- :meth:`~sphinx.application.Sphinx.add_domain()`
- :meth:`~sphinx.application.Sphinx.add_domain`
* - ``Sphinx.import_object()``
- 1.8
@ -1708,10 +1708,10 @@ The following is a list of deprecated interfaces.
- ``sphinx.util.import_object()``
* - ``suffix`` argument of
:meth:`~sphinx.application.Sphinx.add_source_parser()`
:meth:`~sphinx.application.Sphinx.add_source_parser`
- 1.8
- 3.0
- :meth:`~sphinx.application.Sphinx.add_source_suffix()`
- :meth:`~sphinx.application.Sphinx.add_source_suffix`
* - ``BuildEnvironment.load()``
@ -1792,7 +1792,7 @@ The following is a list of deprecated interfaces.
* - :confval:`!source_parsers`
- 1.8
- 3.0
- :meth:`~sphinx.application.Sphinx.add_source_parser()`
- :meth:`~sphinx.application.Sphinx.add_source_parser`
* - ``sphinx.util.docutils.directive_helper()``
- 1.8
@ -1812,17 +1812,17 @@ The following is a list of deprecated interfaces.
* - ``sphinx.locale.l_()``
- 1.8
- 3.0
- :func:`sphinx.locale._()`
- :func:`sphinx.locale._`
* - ``sphinx.locale.lazy_gettext()``
- 1.8
- 3.0
- :func:`sphinx.locale._()`
- :func:`sphinx.locale._`
* - ``sphinx.locale.mygettext()``
- 1.8
- 3.0
- :func:`sphinx.locale._()`
- :func:`sphinx.locale._`
* - ``sphinx.util.copy_static_entry()``
- 1.5
@ -1857,17 +1857,17 @@ The following is a list of deprecated interfaces.
* - ``sphinx.ext.autodoc.add_documenter()``
- 1.7
- 2.0
- :meth:`~sphinx.application.Sphinx.add_autodocumenter()`
- :meth:`~sphinx.application.Sphinx.add_autodocumenter`
* - ``sphinx.ext.autodoc.AutoDirective._register``
- 1.7
- 2.0
- :meth:`~sphinx.application.Sphinx.add_autodocumenter()`
- :meth:`~sphinx.application.Sphinx.add_autodocumenter`
* - ``AutoDirective._special_attrgetters``
- 1.7
- 2.0
- :meth:`~sphinx.application.Sphinx.add_autodoc_attrgetter()`
- :meth:`~sphinx.application.Sphinx.add_autodoc_attrgetter`
* - ``Sphinx.warn()``, ``Sphinx.info()``
- 1.6

View File

@ -12,7 +12,7 @@ __ https://docutils.sourceforge.io/docs/dev/hacking.html#parsing-the-document
In Sphinx, the parser modules works as same as docutils. The parsers are
registered to Sphinx by extensions using Application APIs;
:meth:`.Sphinx.add_source_suffix()` and :meth:`.Sphinx.add_source_parser()`.
:meth:`.Sphinx.add_source_suffix` and :meth:`.Sphinx.add_source_parser`.
The *source suffix* is a mapping from file suffix to file type. For example,
``.rst`` file is mapped to ``'restructuredtext'`` type. Sphinx uses the

View File

@ -1612,7 +1612,7 @@ and also make use of these options.
The special attribute *priority* can be set as an integer
to load the CSS file at an earlier or later step.
For more information, refer to :meth:`.Sphinx.add_css_file()`.
For more information, refer to :meth:`.Sphinx.add_css_file`.
.. versionadded:: 1.8
.. versionchanged:: 3.5
@ -1641,7 +1641,7 @@ and also make use of these options.
As a special attribute, *priority* can be set as an integer
to load the JavaScript file at an earlier or later step.
For more information, refer to :meth:`.Sphinx.add_js_file()`.
For more information, refer to :meth:`.Sphinx.add_js_file`.
.. versionadded:: 1.8
.. versionchanged:: 3.5

View File

@ -840,7 +840,7 @@ __ https://pygments.org/docs/lexers
Strip indentation characters from the code block. When number given,
leading N characters are removed. When no argument given, leading spaces
are removed via :func:`textwrap.dedent()`. For example::
are removed via :func:`textwrap.dedent`. For example::
.. code-block:: ruby
:linenos: