diff --git a/.github/workflows/create-release.yml b/.github/workflows/create-release.yml
new file mode 100644
index 00000000000..cd86ec2fd2a
--- /dev/null
+++ b/.github/workflows/create-release.yml
@@ -0,0 +1,18 @@
+name: Create release
+
+on:
+ push:
+ tags:
+ - "v*.*.*"
+
+jobs:
+ create-release:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v2
+ - name: Release
+ uses: softprops/action-gh-release@v1
+ if: startsWith(github.ref, 'refs/tags/')
+ with:
+ body: "Changelog: https://www.sphinx-doc.org/en/master/changes.html"
diff --git a/CHANGES b/CHANGES
index 77cf9c567a2..5bfc8171d84 100644
--- a/CHANGES
+++ b/CHANGES
@@ -41,9 +41,14 @@ Deprecated
Features added
--------------
+* #9815: html theme: Wrap sidebar components in div to allow customizing their
+ layout via CSS
+
Bugs fixed
----------
+* #9857: Generated RFC links use outdated base url
+
Testing
--------
@@ -65,6 +70,9 @@ Features added
Bugs fixed
----------
+* #9838: autodoc: AttributeError is raised on building document for functions
+ decorated by functools.lru_cache
+
Testing
--------
@@ -1675,6 +1683,14 @@ Bugs fixed
:confval:`intersphinx_mapping` on :event:`config-inited` event
* #7343: Sphinx builds has been slower since 2.4.0 on debug mode
+Release 2.4.5 (released Nov 18, 2021)
+=====================================
+
+Dependencies
+------------
+
+* #9807: Restrict docutils to 0.17.x or older
+
Release 2.4.4 (released Mar 05, 2020)
=====================================
@@ -2511,6 +2527,14 @@ Testing
* Add a helper function: ``sphinx.testing.restructuredtext.parse()``
+Release 1.8.6 (released Nov 18, 2021)
+=====================================
+
+Dependencies
+------------
+
+* #9807: Restrict docutils to 0.17.x or older
+
Release 1.8.5 (released Mar 10, 2019)
=====================================
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index b1efe4a1653..3728fe887e3 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -1005,7 +1005,7 @@ that use Sphinx's HTMLWriter class.
to indicate the location of document using `The Canonical Link Relation`_.
Default: ``''``.
- .. _The Canonical Link Relation: https://tools.ietf.org/html/rfc6596
+ .. _The Canonical Link Relation: https://datatracker.ietf.org/doc/html/rfc6596
.. versionadded:: 1.8
@@ -2679,7 +2679,7 @@ Options for the linkcheck builder
doubling the wait time between attempts until it succeeds or exceeds the
``linkcheck_rate_limit_timeout``. By default, the timeout is 5 minutes.
- .. _Retry-After: https://tools.ietf.org/html/rfc7231#section-7.1.3
+ .. _Retry-After: https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.3
.. versionadded:: 3.4
diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py
index dc494add122..478db40e672 100644
--- a/sphinx/environment/__init__.py
+++ b/sphinx/environment/__init__.py
@@ -51,7 +51,7 @@
'cloak_email_addresses': True,
'pep_base_url': 'https://www.python.org/dev/peps/',
'pep_references': None,
- 'rfc_base_url': 'https://tools.ietf.org/html/',
+ 'rfc_base_url': 'https://datatracker.ietf.org/doc/html/',
'rfc_references': None,
'input_encoding': 'utf-8-sig',
'doctitle_xform': False,
diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.mo b/sphinx/locale/cy/LC_MESSAGES/sphinx.mo
index 04d0325999a..97cde223af3 100644
Binary files a/sphinx/locale/cy/LC_MESSAGES/sphinx.mo and b/sphinx/locale/cy/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.po b/sphinx/locale/cy/LC_MESSAGES/sphinx.po
index 764ab677daa..4e5a09717d8 100644
--- a/sphinx/locale/cy/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cy/LC_MESSAGES/sphinx.po
@@ -9,8 +9,8 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-11-07 00:10+0000\n"
-"PO-Revision-Date: 2021-10-10 00:10+0000\n"
+"POT-Creation-Date: 2021-11-14 00:10+0000\n"
+"PO-Revision-Date: 2021-11-14 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Welsh (http://www.transifex.com/sphinx-doc/sphinx-1/language/cy/)\n"
"MIME-Version: 1.0\n"
@@ -74,76 +74,76 @@ msgstr ""
msgid "loading translations [%s]... "
msgstr ""
-#: sphinx/application.py:296 sphinx/util/__init__.py:539
+#: sphinx/application.py:297 sphinx/util/__init__.py:539
msgid "done"
msgstr ""
-#: sphinx/application.py:298
+#: sphinx/application.py:299
msgid "not available for built-in messages"
msgstr ""
-#: sphinx/application.py:307
+#: sphinx/application.py:308
msgid "loading pickled environment"
msgstr ""
-#: sphinx/application.py:312
+#: sphinx/application.py:313
#, python-format
msgid "failed: %s"
msgstr ""
-#: sphinx/application.py:320
+#: sphinx/application.py:321
msgid "No builder selected, using default: html"
msgstr ""
-#: sphinx/application.py:348
+#: sphinx/application.py:349
msgid "succeeded"
msgstr ""
-#: sphinx/application.py:349
+#: sphinx/application.py:350
msgid "finished with problems"
msgstr ""
-#: sphinx/application.py:353
+#: sphinx/application.py:354
#, python-format
msgid "build %s, %s warning (with warnings treated as errors)."
msgstr ""
-#: sphinx/application.py:355
+#: sphinx/application.py:356
#, python-format
msgid "build %s, %s warnings (with warnings treated as errors)."
msgstr ""
-#: sphinx/application.py:358
+#: sphinx/application.py:359
#, python-format
msgid "build %s, %s warning."
msgstr ""
-#: sphinx/application.py:360
+#: sphinx/application.py:361
#, python-format
msgid "build %s, %s warnings."
msgstr ""
-#: sphinx/application.py:364
+#: sphinx/application.py:365
#, python-format
msgid "build %s."
msgstr ""
-#: sphinx/application.py:594
+#: sphinx/application.py:595
#, python-format
msgid "node class %r is already registered, its visitors will be overridden"
msgstr ""
-#: sphinx/application.py:672
+#: sphinx/application.py:673
#, python-format
msgid "directive %r is already registered, it will be overridden"
msgstr ""
-#: sphinx/application.py:693 sphinx/application.py:714
+#: sphinx/application.py:694 sphinx/application.py:715
#, python-format
msgid "role %r is already registered, it will be overridden"
msgstr ""
-#: sphinx/application.py:1245
+#: sphinx/application.py:1246
#, python-format
msgid ""
"the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +151,12 @@ msgid ""
"explicit"
msgstr ""
-#: sphinx/application.py:1249
+#: sphinx/application.py:1250
#, python-format
msgid "the %s extension is not safe for parallel reading"
msgstr ""
-#: sphinx/application.py:1252
+#: sphinx/application.py:1253
#, python-format
msgid ""
"the %s extension does not declare if it is safe for parallel writing, "
@@ -164,64 +164,64 @@ msgid ""
"explicit"
msgstr ""
-#: sphinx/application.py:1256
+#: sphinx/application.py:1257
#, python-format
msgid "the %s extension is not safe for parallel writing"
msgstr ""
-#: sphinx/application.py:1264 sphinx/application.py:1268
+#: sphinx/application.py:1265 sphinx/application.py:1269
#, python-format
msgid "doing serial %s"
msgstr ""
-#: sphinx/config.py:170
+#: sphinx/config.py:171
#, python-format
msgid "config directory doesn't contain a conf.py file (%s)"
msgstr ""
-#: sphinx/config.py:197
+#: sphinx/config.py:198
#, python-format
msgid ""
"cannot override dictionary config setting %r, ignoring (use %r to set "
"individual elements)"
msgstr ""
-#: sphinx/config.py:206
+#: sphinx/config.py:207
#, python-format
msgid "invalid number %r for config value %r, ignoring"
msgstr ""
-#: sphinx/config.py:211
+#: sphinx/config.py:212
#, python-format
msgid "cannot override config setting %r with unsupported type, ignoring"
msgstr ""
-#: sphinx/config.py:240
+#: sphinx/config.py:241
#, python-format
msgid "unknown config value %r in override, ignoring"
msgstr ""
-#: sphinx/config.py:257
+#: sphinx/config.py:258
#, python-format
msgid "No such config value: %s"
msgstr ""
-#: sphinx/config.py:281
+#: sphinx/config.py:282
#, python-format
msgid "Config value %r already present"
msgstr ""
-#: sphinx/config.py:330
+#: sphinx/config.py:331
#, python-format
msgid "There is a syntax error in your configuration file: %s\n"
msgstr ""
-#: sphinx/config.py:333
+#: sphinx/config.py:334
msgid ""
"The configuration file (or one of the modules it imports) called sys.exit()"
msgstr ""
-#: sphinx/config.py:340
+#: sphinx/config.py:341
#, python-format
msgid ""
"There is a programmable error in your configuration file:\n"
@@ -229,57 +229,57 @@ msgid ""
"%s"
msgstr ""
-#: sphinx/config.py:366
+#: sphinx/config.py:367
#, python-format
msgid ""
"The config value `source_suffix' expects a string, list of strings, or "
"dictionary. But `%r' is given."
msgstr ""
-#: sphinx/config.py:385
+#: sphinx/config.py:386
#, python-format
msgid "Section %s"
msgstr ""
-#: sphinx/config.py:386
+#: sphinx/config.py:387
#, python-format
msgid "Fig. %s"
msgstr "Ffig. %s"
-#: sphinx/config.py:387
+#: sphinx/config.py:388
#, python-format
msgid "Table %s"
msgstr "Tabl %s"
-#: sphinx/config.py:388
+#: sphinx/config.py:389
#, python-format
msgid "Listing %s"
msgstr "Listing %s"
-#: sphinx/config.py:425
+#: sphinx/config.py:426
msgid ""
"The config value `{name}` has to be a one of {candidates}, but `{current}` "
"is given."
msgstr ""
-#: sphinx/config.py:443
+#: sphinx/config.py:444
msgid ""
"The config value `{name}' has type `{current.__name__}'; expected "
"{permitted}."
msgstr ""
-#: sphinx/config.py:456
+#: sphinx/config.py:457
msgid ""
"The config value `{name}' has type `{current.__name__}', defaults to "
"`{default.__name__}'."
msgstr ""
-#: sphinx/config.py:466
+#: sphinx/config.py:467
#, python-format
msgid "primary_domain %r not found, ignored."
msgstr ""
-#: sphinx/config.py:478
+#: sphinx/config.py:479
msgid ""
"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
"\"root_doc = 'contents'\" to your conf.py."
@@ -521,104 +521,104 @@ msgstr ""
msgid "building [mo]: "
msgstr ""
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535
-#: sphinx/builders/__init__.py:561
+#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
+#: sphinx/builders/__init__.py:562
msgid "writing output... "
msgstr ""
-#: sphinx/builders/__init__.py:225
+#: sphinx/builders/__init__.py:226
#, python-format
msgid "all of %d po files"
msgstr ""
-#: sphinx/builders/__init__.py:243
+#: sphinx/builders/__init__.py:244
#, python-format
msgid "targets for %d po files that are specified"
msgstr ""
-#: sphinx/builders/__init__.py:250
+#: sphinx/builders/__init__.py:251
#, python-format
msgid "targets for %d po files that are out of date"
msgstr ""
-#: sphinx/builders/__init__.py:257
+#: sphinx/builders/__init__.py:258
msgid "all source files"
msgstr ""
-#: sphinx/builders/__init__.py:269
+#: sphinx/builders/__init__.py:270
#, python-format
msgid ""
"file %r given on command line is not under the source directory, ignoring"
msgstr ""
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:274
#, python-format
msgid "file %r given on command line does not exist, ignoring"
msgstr ""
-#: sphinx/builders/__init__.py:284
+#: sphinx/builders/__init__.py:285
#, python-format
msgid "%d source files given on command line"
msgstr ""
-#: sphinx/builders/__init__.py:294
+#: sphinx/builders/__init__.py:295
#, python-format
msgid "targets for %d source files that are out of date"
msgstr ""
-#: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
#, python-format
msgid "building [%s]: "
msgstr ""
-#: sphinx/builders/__init__.py:310
+#: sphinx/builders/__init__.py:311
msgid "looking for now-outdated files... "
msgstr ""
-#: sphinx/builders/__init__.py:315
+#: sphinx/builders/__init__.py:316
#, python-format
msgid "%d found"
msgstr ""
-#: sphinx/builders/__init__.py:317
+#: sphinx/builders/__init__.py:318
msgid "none found"
msgstr ""
-#: sphinx/builders/__init__.py:322
+#: sphinx/builders/__init__.py:323
msgid "pickling environment"
msgstr ""
-#: sphinx/builders/__init__.py:328
+#: sphinx/builders/__init__.py:329
msgid "checking consistency"
msgstr ""
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:333
msgid "no targets are out of date."
msgstr ""
-#: sphinx/builders/__init__.py:371
+#: sphinx/builders/__init__.py:372
msgid "updating environment: "
msgstr ""
-#: sphinx/builders/__init__.py:392
+#: sphinx/builders/__init__.py:393
#, python-format
msgid "%s added, %s changed, %s removed"
msgstr ""
-#: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457
+#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
msgid "reading sources... "
msgstr ""
-#: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571
+#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
msgid "waiting for workers..."
msgstr ""
-#: sphinx/builders/__init__.py:513
+#: sphinx/builders/__init__.py:514
#, python-format
msgid "docnames to write: %s"
msgstr ""
-#: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
msgid "preparing documents"
msgstr ""
@@ -1811,22 +1811,50 @@ msgstr ""
msgid "Line spec %r: no lines pulled from include file %r"
msgstr ""
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:110
+#, python-format
+msgid "toctree glob pattern %r didn't match any documents"
+msgstr ""
+
+#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#, python-format
+msgid "toctree contains reference to excluded document %r"
+msgstr ""
+
+#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#, python-format
+msgid "toctree contains reference to nonexisting document %r"
+msgstr ""
+
+#: sphinx/directives/other.py:144
+#, python-format
+msgid "duplicated entry found in toctree: %s"
+msgstr ""
+
+#: sphinx/directives/other.py:176
msgid "Section author: "
msgstr "Awdur yr adran:"
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:178
msgid "Module author: "
msgstr "Awdur y fodiwl:"
-#: sphinx/directives/other.py:179
+#: sphinx/directives/other.py:180
msgid "Code author: "
msgstr "Awdur y cod:"
-#: sphinx/directives/other.py:181
+#: sphinx/directives/other.py:182
msgid "Author: "
msgstr "Awdur:"
+#: sphinx/directives/other.py:254
+msgid ".. acks content is not a list"
+msgstr ""
+
+#: sphinx/directives/other.py:279
+msgid ".. hlist content is not a list"
+msgstr ""
+
#: sphinx/directives/patches.py:118
msgid ""
"\":file:\" option for csv-table directive now recognizes an absolute path as"
@@ -1878,7 +1906,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1178
msgid "function"
msgstr "ffwythiant"
@@ -1956,7 +1984,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1180
msgid "class"
msgstr ""
@@ -1973,7 +2001,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:817
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -1988,7 +2016,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr "%s (newidyn byd-eang neu cysonyn)"
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:902
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2002,20 +2030,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1182
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1179
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1185
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1177
+#: sphinx/domains/python.py:1187
msgid "module"
msgstr "modiwl"
@@ -2046,7 +2074,7 @@ msgstr "gweithredydd"
msgid "object"
msgstr "gwrthrych"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1181
msgid "exception"
msgstr ""
@@ -2066,84 +2094,84 @@ msgstr ""
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
+#: sphinx/domains/python.py:662 sphinx/domains/python.py:806
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
-#: sphinx/domains/python.py:939
+#: sphinx/domains/python.py:722 sphinx/domains/python.py:898
+#: sphinx/domains/python.py:949
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:714
+#: sphinx/domains/python.py:724
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:739
+#: sphinx/domains/python.py:749
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:740
+#: sphinx/domains/python.py:750
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:811
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
+#: sphinx/domains/python.py:813 sphinx/domains/python.py:953
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:805
+#: sphinx/domains/python.py:815
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1097
+#: sphinx/domains/python.py:1107
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1098
+#: sphinx/domains/python.py:1108
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1147
+#: sphinx/domains/python.py:1157
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1183
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1174
+#: sphinx/domains/python.py:1184
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1186
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1234
+#: sphinx/domains/python.py:1244
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1354
+#: sphinx/domains/python.py:1364
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1408
+#: sphinx/domains/python.py:1418
msgid " (deprecated)"
msgstr ""
@@ -2365,16 +2393,6 @@ msgid ""
" will be generated"
msgstr ""
-#: sphinx/environment/adapters/toctree.py:176
-#, python-format
-msgid "toctree contains reference to excluded document %r"
-msgstr ""
-
-#: sphinx/environment/adapters/toctree.py:178
-#, python-format
-msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
-
#: sphinx/environment/collectors/asset.py:90
#, python-format
msgid "image file not readable: %s"
@@ -3147,7 +3165,7 @@ msgid "page"
msgstr ""
#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
+#: sphinx/themes/basic/localtoc.html:12 sphinx/themes/scrolls/layout.html:41
msgid "Table of Contents"
msgstr ""
@@ -3272,19 +3290,19 @@ msgstr ""
msgid "Search %(docstitle)s"
msgstr "Chwilio %(docstitle)s"
-#: sphinx/themes/basic/relations.html:11
+#: sphinx/themes/basic/relations.html:12
msgid "Previous topic"
msgstr "Pwnc blaenorol"
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:14
msgid "previous chapter"
msgstr "pennod blaenorol"
-#: sphinx/themes/basic/relations.html:16
+#: sphinx/themes/basic/relations.html:19
msgid "Next topic"
msgstr "Pwnc nesaf"
-#: sphinx/themes/basic/relations.html:18
+#: sphinx/themes/basic/relations.html:21
msgid "next chapter"
msgstr "pennod nesaf"
diff --git a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo
index 40f5ddefb9c..6e8e50fd32f 100644
Binary files a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo and b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
index 184ee7a89f9..5ca18f568d7 100644
--- a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: English (United Kingdom) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_GB/)\n"
@@ -1849,7 +1849,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr ""
@@ -1858,12 +1858,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr ""
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr ""
@@ -1876,7 +1876,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr ""
@@ -1954,7 +1954,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr ""
@@ -1971,7 +1971,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -1986,7 +1986,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2000,20 +2000,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr ""
@@ -2044,7 +2044,7 @@ msgstr ""
msgid "object"
msgstr ""
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr ""
@@ -2056,92 +2056,92 @@ msgstr ""
msgid "built-in function"
msgstr ""
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr ""
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr ""
@@ -2702,42 +2702,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2908,7 +2908,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.mo b/sphinx/locale/es/LC_MESSAGES/sphinx.mo
index eabd0e5998e..11107649aeb 100644
Binary files a/sphinx/locale/es/LC_MESSAGES/sphinx.mo and b/sphinx/locale/es/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.po b/sphinx/locale/es/LC_MESSAGES/sphinx.po
index 0c55ca1e73d..547e7ea703a 100644
--- a/sphinx/locale/es/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/es/LC_MESSAGES/sphinx.po
@@ -14,7 +14,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Spanish (http://www.transifex.com/sphinx-doc/sphinx-1/language/es/)\n"
@@ -1856,7 +1856,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr "Parámetros"
@@ -1865,12 +1865,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr "Devuelve"
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr "Tipo del valor devuelto"
@@ -1883,7 +1883,7 @@ msgid "variable"
msgstr "variable"
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr "función"
@@ -1961,7 +1961,7 @@ msgid "Throws"
msgstr "Lanzamientos"
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr "clase"
@@ -1978,7 +1978,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr "%s() (función incorporada)"
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr "%s() (método de %s)"
@@ -1993,7 +1993,7 @@ msgstr "%s() (clase)"
msgid "%s (global variable or constant)"
msgstr "%s (variable global o constante)"
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr "%s (atributo de %s)"
@@ -2007,20 +2007,20 @@ msgstr "Argumentos"
msgid "%s (module)"
msgstr "%s (módulo)"
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr "método"
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr "dato"
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr "atributo"
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr "módulo"
@@ -2051,7 +2051,7 @@ msgstr "operador"
msgid "object"
msgstr "objeto"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr "excepción"
@@ -2063,92 +2063,92 @@ msgstr "sentencia"
msgid "built-in function"
msgstr "función incorporada"
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr "Variables"
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr "Muestra"
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr "%s() (en el módulo %s)"
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr "%s (en el módulo %s)"
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr "%s (variable incorporada)"
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr "%s (clase incorporada)"
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr "%s (clase en %s)"
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr "%s() (método de clase de %s)"
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr "%s() (método estático de %s)"
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr "Índice de Módulos Python"
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr "módulos"
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr "Obsoleto"
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr "método de la clase"
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr "método estático"
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr "descripción duplicada del objeto de %s, otra instancia en %s, utilice :noindex: para uno de ellos"
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr "se encontró más de un objetivo para la referencia cruzada %r: %s"
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr " (obsoleto)"
@@ -2709,42 +2709,42 @@ msgstr "en línea latex %r: %s"
msgid "Permalink to this equation"
msgstr "Enlace permanente a esta ecuación"
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr "el inventario intersphinx se ha movido: %s -> %s"
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr "cargando inventario intersphinx desde %s..."
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr "encontró algunos problemas con algunos de los inventarios, pero tenían alternativas de trabajo:"
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr "no se pudo llegar a ninguno de los inventarios con los siguientes problemas:"
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr "(en %s versión %s)"
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr "(en %s)"
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr "el identificador de intersphinx %r no es una cadena. Ignorado"
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr "Error al leer intersphinx_mapping[%s], ignorado: %r"
@@ -2915,7 +2915,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.mo b/sphinx/locale/fa/LC_MESSAGES/sphinx.mo
index eed51abdad0..344d1eeb3f3 100644
Binary files a/sphinx/locale/fa/LC_MESSAGES/sphinx.mo and b/sphinx/locale/fa/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.po b/sphinx/locale/fa/LC_MESSAGES/sphinx.po
index 944b6bd34e5..29f3eb2ecfc 100644
--- a/sphinx/locale/fa/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fa/LC_MESSAGES/sphinx.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-11-07 00:10+0000\n"
+"POT-Creation-Date: 2021-11-14 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Persian (http://www.transifex.com/sphinx-doc/sphinx-1/language/fa/)\n"
@@ -76,76 +76,76 @@ msgstr "'setup' آن طور که در conf.py تعریف شده شیئ قابل
msgid "loading translations [%s]... "
msgstr "بارگذاری ترجمه ها [%s]... "
-#: sphinx/application.py:296 sphinx/util/__init__.py:539
+#: sphinx/application.py:297 sphinx/util/__init__.py:539
msgid "done"
msgstr "انجام شد"
-#: sphinx/application.py:298
+#: sphinx/application.py:299
msgid "not available for built-in messages"
msgstr "برای پیامهای داخلی در دسترس نیست"
-#: sphinx/application.py:307
+#: sphinx/application.py:308
msgid "loading pickled environment"
msgstr "بارگذاری محیط pckle شده"
-#: sphinx/application.py:312
+#: sphinx/application.py:313
#, python-format
msgid "failed: %s"
msgstr "شکست خورد: %s"
-#: sphinx/application.py:320
+#: sphinx/application.py:321
msgid "No builder selected, using default: html"
msgstr "هیچ سازندهای برگزیده نشده، استفاده از قالب خروجی پیشفرض: html"
-#: sphinx/application.py:348
+#: sphinx/application.py:349
msgid "succeeded"
msgstr "موفّقیّتآمیز بود"
-#: sphinx/application.py:349
+#: sphinx/application.py:350
msgid "finished with problems"
msgstr "انجام شد ولی با مشکل"
-#: sphinx/application.py:353
+#: sphinx/application.py:354
#, python-format
msgid "build %s, %s warning (with warnings treated as errors)."
msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار میشود)."
-#: sphinx/application.py:355
+#: sphinx/application.py:356
#, python-format
msgid "build %s, %s warnings (with warnings treated as errors)."
msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار میشود)."
-#: sphinx/application.py:358
+#: sphinx/application.py:359
#, python-format
msgid "build %s, %s warning."
msgstr "ساخت %s، %s هشدار."
-#: sphinx/application.py:360
+#: sphinx/application.py:361
#, python-format
msgid "build %s, %s warnings."
msgstr "ساخت %s، %s هشدار."
-#: sphinx/application.py:364
+#: sphinx/application.py:365
#, python-format
msgid "build %s."
msgstr "ساخت %s."
-#: sphinx/application.py:594
+#: sphinx/application.py:595
#, python-format
msgid "node class %r is already registered, its visitors will be overridden"
msgstr "بست کلاس %r در حال حاضر ثبت نام شده است، بازدیدکنندگان این پیوند نادیده گرفته خواهد شد"
-#: sphinx/application.py:672
+#: sphinx/application.py:673
#, python-format
msgid "directive %r is already registered, it will be overridden"
msgstr "دستور %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد"
-#: sphinx/application.py:693 sphinx/application.py:714
+#: sphinx/application.py:694 sphinx/application.py:715
#, python-format
msgid "role %r is already registered, it will be overridden"
msgstr "نقش %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد"
-#: sphinx/application.py:1245
+#: sphinx/application.py:1246
#, python-format
msgid ""
"the %s extension does not declare if it is safe for parallel reading, "
@@ -153,12 +153,12 @@ msgid ""
"explicit"
msgstr "افزونهی %s مشخّص نکرده که آیا برای خواندن موازی امن هست یا نه. که فرض میگیریم نیست. لطفاً از نویسندهی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند"
-#: sphinx/application.py:1249
+#: sphinx/application.py:1250
#, python-format
msgid "the %s extension is not safe for parallel reading"
msgstr "افزونه ی %sبرای خواندن موازی امن نیست"
-#: sphinx/application.py:1252
+#: sphinx/application.py:1253
#, python-format
msgid ""
"the %s extension does not declare if it is safe for parallel writing, "
@@ -166,64 +166,64 @@ msgid ""
"explicit"
msgstr "افزونهی %s مشخّص نکرده که آیا برای نوشتن موازی امن هست یا نه. که فرض میگیریم نیست. لطفاً از نویسندهی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند"
-#: sphinx/application.py:1256
+#: sphinx/application.py:1257
#, python-format
msgid "the %s extension is not safe for parallel writing"
msgstr "افزونهی %s برای نوشتن موازی امن نیست"
-#: sphinx/application.py:1264 sphinx/application.py:1268
+#: sphinx/application.py:1265 sphinx/application.py:1269
#, python-format
msgid "doing serial %s"
msgstr "انجام چندبارهی %s"
-#: sphinx/config.py:170
+#: sphinx/config.py:171
#, python-format
msgid "config directory doesn't contain a conf.py file (%s)"
msgstr "شاخهی پیکربندی(%s)، پروندهی conf.py را ندارد"
-#: sphinx/config.py:197
+#: sphinx/config.py:198
#, python-format
msgid ""
"cannot override dictionary config setting %r, ignoring (use %r to set "
"individual elements)"
msgstr "امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته میشود (برای تعیین تک تک عناصر %r را به کار ببرید)"
-#: sphinx/config.py:206
+#: sphinx/config.py:207
#, python-format
msgid "invalid number %r for config value %r, ignoring"
msgstr "شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته میشود"
-#: sphinx/config.py:211
+#: sphinx/config.py:212
#, python-format
msgid "cannot override config setting %r with unsupported type, ignoring"
msgstr "امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته میشود"
-#: sphinx/config.py:240
+#: sphinx/config.py:241
#, python-format
msgid "unknown config value %r in override, ignoring"
msgstr "مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد"
-#: sphinx/config.py:257
+#: sphinx/config.py:258
#, python-format
msgid "No such config value: %s"
msgstr "چنین مقداری برای پیکربندی نبود: %s"
-#: sphinx/config.py:281
+#: sphinx/config.py:282
#, python-format
msgid "Config value %r already present"
msgstr "مقدار پیکربندی %r از قبل موجود است"
-#: sphinx/config.py:330
+#: sphinx/config.py:331
#, python-format
msgid "There is a syntax error in your configuration file: %s\n"
msgstr "خطای نحوی در پروندهی پیکربندی شما وجود دارد: %s\n"
-#: sphinx/config.py:333
+#: sphinx/config.py:334
msgid ""
"The configuration file (or one of the modules it imports) called sys.exit()"
msgstr "پروندهی پیکربندی (یا یکی از ماژول هایی که وارد می کند) sys.exit() را فراخواند"
-#: sphinx/config.py:340
+#: sphinx/config.py:341
#, python-format
msgid ""
"There is a programmable error in your configuration file:\n"
@@ -231,57 +231,57 @@ msgid ""
"%s"
msgstr "یک خطای قابل برنامه ریزی در پروندهی پیکربندی شما وجود دارد:\n\n%s"
-#: sphinx/config.py:366
+#: sphinx/config.py:367
#, python-format
msgid ""
"The config value `source_suffix' expects a string, list of strings, or "
"dictionary. But `%r' is given."
msgstr "مقدار پیکربندی 'source_suffix' انتظار یک رشته، لیست رشته ها، یا فرهنگ لغت را داشت. اما '%r' داده شده است."
-#: sphinx/config.py:385
+#: sphinx/config.py:386
#, python-format
msgid "Section %s"
msgstr "بخش%s"
-#: sphinx/config.py:386
+#: sphinx/config.py:387
#, python-format
msgid "Fig. %s"
msgstr "شکل %s"
-#: sphinx/config.py:387
+#: sphinx/config.py:388
#, python-format
msgid "Table %s"
msgstr "جدول %s"
-#: sphinx/config.py:388
+#: sphinx/config.py:389
#, python-format
msgid "Listing %s"
msgstr "فهرست %s"
-#: sphinx/config.py:425
+#: sphinx/config.py:426
msgid ""
"The config value `{name}` has to be a one of {candidates}, but `{current}` "
"is given."
msgstr "مقدار پیکربندی '{name}' باید یکی از {candidates} باشد، اما '{current}' داده شده."
-#: sphinx/config.py:443
+#: sphinx/config.py:444
msgid ""
"The config value `{name}' has type `{current.__name__}'; expected "
"{permitted}."
msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، ولی انتظار میرفت {permitted} میبود."
-#: sphinx/config.py:456
+#: sphinx/config.py:457
msgid ""
"The config value `{name}' has type `{current.__name__}', defaults to "
"`{default.__name__}'."
msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، حالت پیشفرض {permitted} است."
-#: sphinx/config.py:466
+#: sphinx/config.py:467
#, python-format
msgid "primary_domain %r not found, ignored."
msgstr "دامنهی اصلی %r یافت نشد، نادیده گرفته میشوند."
-#: sphinx/config.py:478
+#: sphinx/config.py:479
msgid ""
"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
"\"root_doc = 'contents'\" to your conf.py."
@@ -523,104 +523,104 @@ msgstr "تصویر مناسبی برای سازندهی %s پیدا نشد: %
msgid "building [mo]: "
msgstr "ساخت پروندهی [mo]: "
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535
-#: sphinx/builders/__init__.py:561
+#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
+#: sphinx/builders/__init__.py:562
msgid "writing output... "
msgstr "نوشتن برونداد... "
-#: sphinx/builders/__init__.py:225
+#: sphinx/builders/__init__.py:226
#, python-format
msgid "all of %d po files"
msgstr "همهی پروندههای %d po"
-#: sphinx/builders/__init__.py:243
+#: sphinx/builders/__init__.py:244
#, python-format
msgid "targets for %d po files that are specified"
msgstr "اهداف برای %d پروندههای poی که مشخّص شده"
-#: sphinx/builders/__init__.py:250
+#: sphinx/builders/__init__.py:251
#, python-format
msgid "targets for %d po files that are out of date"
msgstr "مقصدهای %d پروندههای poی هستند که منسوخ شدهاند"
-#: sphinx/builders/__init__.py:257
+#: sphinx/builders/__init__.py:258
msgid "all source files"
msgstr "همهی پروندههای منبع"
-#: sphinx/builders/__init__.py:269
+#: sphinx/builders/__init__.py:270
#, python-format
msgid ""
"file %r given on command line is not under the source directory, ignoring"
msgstr "پروندهی %r که در خط فرمان داده شده، در شاخهی منبع نیست, نادیده گرفته میشود"
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:274
#, python-format
msgid "file %r given on command line does not exist, ignoring"
msgstr "پروندهی %r که در خط فرمان داده شده، وجود ندارد، نادیده گرفته میشود"
-#: sphinx/builders/__init__.py:284
+#: sphinx/builders/__init__.py:285
#, python-format
msgid "%d source files given on command line"
msgstr "پروندههای منبع %d داده شده در خط فرمان"
-#: sphinx/builders/__init__.py:294
+#: sphinx/builders/__init__.py:295
#, python-format
msgid "targets for %d source files that are out of date"
msgstr "مقصدهای %d پروندههای منبعی هستند که منسوخ شدهاند"
-#: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
#, python-format
msgid "building [%s]: "
msgstr "ساخت [%s]: "
-#: sphinx/builders/__init__.py:310
+#: sphinx/builders/__init__.py:311
msgid "looking for now-outdated files... "
msgstr "در پی پروندههایی که الآن منسوخ هستند... "
-#: sphinx/builders/__init__.py:315
+#: sphinx/builders/__init__.py:316
#, python-format
msgid "%d found"
msgstr "%d تا مورد پیدا شد"
-#: sphinx/builders/__init__.py:317
+#: sphinx/builders/__init__.py:318
msgid "none found"
msgstr "چیزی پیدا نشد"
-#: sphinx/builders/__init__.py:322
+#: sphinx/builders/__init__.py:323
msgid "pickling environment"
msgstr "بارگذاری محیط pickle شده"
-#: sphinx/builders/__init__.py:328
+#: sphinx/builders/__init__.py:329
msgid "checking consistency"
msgstr "بررسی ثبات"
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:333
msgid "no targets are out of date."
msgstr "هیچ مقدار تاریخ منسوخ نیست."
-#: sphinx/builders/__init__.py:371
+#: sphinx/builders/__init__.py:372
msgid "updating environment: "
msgstr "به روز رسانی محیط: "
-#: sphinx/builders/__init__.py:392
+#: sphinx/builders/__init__.py:393
#, python-format
msgid "%s added, %s changed, %s removed"
msgstr "%s اضافه شد، %s تغییر کرد، %s حذف شد"
-#: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457
+#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
msgid "reading sources... "
msgstr "خواندن منبعها... "
-#: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571
+#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
msgid "waiting for workers..."
msgstr "در انتظار برای ابزارهای کارگر..."
-#: sphinx/builders/__init__.py:513
+#: sphinx/builders/__init__.py:514
#, python-format
msgid "docnames to write: %s"
msgstr "نام مستندات برای نوشتن: %s"
-#: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
msgid "preparing documents"
msgstr "آماده سازی اسناد"
@@ -1813,22 +1813,50 @@ msgstr "امکان استفادهی گزینهی «همخوان شما
msgid "Line spec %r: no lines pulled from include file %r"
msgstr "سطر مشخّص شده %r: هیچ سطری از پروندهی گنجانده شده %r بیرون کشیده نشده"
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:110
+#, python-format
+msgid "toctree glob pattern %r didn't match any documents"
+msgstr ""
+
+#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#, python-format
+msgid "toctree contains reference to excluded document %r"
+msgstr "درختوارهی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد"
+
+#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#, python-format
+msgid "toctree contains reference to nonexisting document %r"
+msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است"
+
+#: sphinx/directives/other.py:144
+#, python-format
+msgid "duplicated entry found in toctree: %s"
+msgstr ""
+
+#: sphinx/directives/other.py:176
msgid "Section author: "
msgstr "نویسنده این بخش: "
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:178
msgid "Module author: "
msgstr "نویسنده این ماژول: "
-#: sphinx/directives/other.py:179
+#: sphinx/directives/other.py:180
msgid "Code author: "
msgstr "نویسنده ی کد: "
-#: sphinx/directives/other.py:181
+#: sphinx/directives/other.py:182
msgid "Author: "
msgstr "نویسنده: "
+#: sphinx/directives/other.py:254
+msgid ".. acks content is not a list"
+msgstr ""
+
+#: sphinx/directives/other.py:279
+msgid ".. hlist content is not a list"
+msgstr ""
+
#: sphinx/directives/patches.py:118
msgid ""
"\":file:\" option for csv-table directive now recognizes an absolute path as"
@@ -1880,7 +1908,7 @@ msgid "variable"
msgstr "متغیّر"
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1178
msgid "function"
msgstr "تابع"
@@ -1958,7 +1986,7 @@ msgid "Throws"
msgstr "ایجاد"
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1180
msgid "class"
msgstr "کلاس"
@@ -1975,7 +2003,7 @@ msgstr "مؤلّفهی قالب"
msgid "%s() (built-in function)"
msgstr "%s() (توابع درونی)"
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:817
#, python-format
msgid "%s() (%s method)"
msgstr "%s() (%s متد)"
@@ -1990,7 +2018,7 @@ msgstr "%s (کلاس)"
msgid "%s (global variable or constant)"
msgstr "%s (متغیّر عمومی یا مقدار ثابت)"
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:902
#, python-format
msgid "%s (%s attribute)"
msgstr "%s (%s مشخصه)"
@@ -2004,20 +2032,20 @@ msgstr "نشانوندها"
msgid "%s (module)"
msgstr "%s (ماژول)"
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1182
msgid "method"
msgstr "متد"
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1179
msgid "data"
msgstr "داده"
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1185
msgid "attribute"
msgstr "مشخّصه"
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1177
+#: sphinx/domains/python.py:1187
msgid "module"
msgstr "ماژول"
@@ -2048,7 +2076,7 @@ msgstr "عملگر"
msgid "object"
msgstr "شیء"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1181
msgid "exception"
msgstr "ایراد"
@@ -2068,84 +2096,84 @@ msgstr "متغیر ها"
msgid "Raises"
msgstr "برانگیختن"
-#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
+#: sphinx/domains/python.py:662 sphinx/domains/python.py:806
#, python-format
msgid "%s() (in module %s)"
msgstr "%s() (در ماژول %s)"
-#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
-#: sphinx/domains/python.py:939
+#: sphinx/domains/python.py:722 sphinx/domains/python.py:898
+#: sphinx/domains/python.py:949
#, python-format
msgid "%s (in module %s)"
msgstr "%s (در ماژول %s)"
-#: sphinx/domains/python.py:714
+#: sphinx/domains/python.py:724
#, python-format
msgid "%s (built-in variable)"
msgstr "%s (متغیر درونی)"
-#: sphinx/domains/python.py:739
+#: sphinx/domains/python.py:749
#, python-format
msgid "%s (built-in class)"
msgstr "%s (کلاس درونی)"
-#: sphinx/domains/python.py:740
+#: sphinx/domains/python.py:750
#, python-format
msgid "%s (class in %s)"
msgstr "%s (کلاس در %s)"
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:811
#, python-format
msgid "%s() (%s class method)"
msgstr "%s() (%s شگرد کلاس)"
-#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
+#: sphinx/domains/python.py:813 sphinx/domains/python.py:953
#, python-format
msgid "%s (%s property)"
msgstr "%s(%sویژگی)"
-#: sphinx/domains/python.py:805
+#: sphinx/domains/python.py:815
#, python-format
msgid "%s() (%s static method)"
msgstr "%s() (%s متد استاتیک)"
-#: sphinx/domains/python.py:1097
+#: sphinx/domains/python.py:1107
msgid "Python Module Index"
msgstr "نمایه ی ماژول های پایتون"
-#: sphinx/domains/python.py:1098
+#: sphinx/domains/python.py:1108
msgid "modules"
msgstr "ماژول ها"
-#: sphinx/domains/python.py:1147
+#: sphinx/domains/python.py:1157
msgid "Deprecated"
msgstr "منسوخ شده"
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1183
msgid "class method"
msgstr "class method"
-#: sphinx/domains/python.py:1174
+#: sphinx/domains/python.py:1184
msgid "static method"
msgstr "متد استاتیک"
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1186
msgid "property"
msgstr "ویژگی"
-#: sphinx/domains/python.py:1234
+#: sphinx/domains/python.py:1244
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr "توضیح تکراری شیئ %s، نمونهی دیگر در %s قرار دارد، برای یک مورد از :noindex: استفاده کنید"
-#: sphinx/domains/python.py:1354
+#: sphinx/domains/python.py:1364
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr "برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s"
-#: sphinx/domains/python.py:1408
+#: sphinx/domains/python.py:1418
msgid " (deprecated)"
msgstr " (منسوخ)"
@@ -2367,16 +2395,6 @@ msgid ""
" will be generated"
msgstr "فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد"
-#: sphinx/environment/adapters/toctree.py:176
-#, python-format
-msgid "toctree contains reference to excluded document %r"
-msgstr "درختوارهی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد"
-
-#: sphinx/environment/adapters/toctree.py:178
-#, python-format
-msgid "toctree contains reference to nonexisting document %r"
-msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است"
-
#: sphinx/environment/collectors/asset.py:90
#, python-format
msgid "image file not readable: %s"
@@ -3149,7 +3167,7 @@ msgid "page"
msgstr "صفحه"
#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
+#: sphinx/themes/basic/localtoc.html:12 sphinx/themes/scrolls/layout.html:41
msgid "Table of Contents"
msgstr "فهرست عناوین"
@@ -3274,19 +3292,19 @@ msgstr "ایجاد شده باSphinx
msgid "Search %(docstitle)s"
msgstr "جستجو %(docstitle)s"
-#: sphinx/themes/basic/relations.html:11
+#: sphinx/themes/basic/relations.html:12
msgid "Previous topic"
msgstr "موضوع قبلی"
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:14
msgid "previous chapter"
msgstr "فصل قبلی"
-#: sphinx/themes/basic/relations.html:16
+#: sphinx/themes/basic/relations.html:19
msgid "Next topic"
msgstr "موضوع بعدی"
-#: sphinx/themes/basic/relations.html:18
+#: sphinx/themes/basic/relations.html:21
msgid "next chapter"
msgstr "فصل بعدی"
diff --git a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo
index 0aded7d1da9..8b56d95a33e 100644
Binary files a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo and b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
index e05e86107c2..cf50d26d64d 100644
--- a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: French (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr_FR/)\n"
@@ -1849,7 +1849,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr ""
@@ -1858,12 +1858,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr ""
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr ""
@@ -1876,7 +1876,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr ""
@@ -1954,7 +1954,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr ""
@@ -1971,7 +1971,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -1986,7 +1986,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2000,20 +2000,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr ""
@@ -2044,7 +2044,7 @@ msgstr ""
msgid "object"
msgstr ""
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr ""
@@ -2056,92 +2056,92 @@ msgstr ""
msgid "built-in function"
msgstr ""
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr ""
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr ""
@@ -2702,42 +2702,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2908,7 +2908,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.mo b/sphinx/locale/ja/LC_MESSAGES/sphinx.mo
index ded198ef9f7..d6884dd9a04 100644
Binary files a/sphinx/locale/ja/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ja/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.po b/sphinx/locale/ja/LC_MESSAGES/sphinx.po
index 79d5865e363..95eb6281fd9 100644
--- a/sphinx/locale/ja/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ja/LC_MESSAGES/sphinx.po
@@ -15,7 +15,7 @@
# Takayuki Shimizukawa , 2013-2016
# Takayuki Shimizukawa , 2016-2017,2019
# Komiya Takeshi , 2016-2017,2019
-# Tetsuo Koyama , 2020
+# Tetsuo Koyama , 2020-2021
# tomo, 2019
# shirou - しろう , 2014
# Yasushi Masuda , 2008
@@ -24,8 +24,8 @@ msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
"POT-Creation-Date: 2021-11-07 00:10+0000\n"
-"PO-Revision-Date: 2021-10-10 00:10+0000\n"
-"Last-Translator: Komiya Takeshi \n"
+"PO-Revision-Date: 2021-11-11 12:54+0000\n"
+"Last-Translator: Tetsuo Koyama \n"
"Language-Team: Japanese (http://www.transifex.com/sphinx-doc/sphinx-1/language/ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -297,7 +297,7 @@ msgstr "primary_domain %r が見つかりません。無視します。"
msgid ""
"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
"\"root_doc = 'contents'\" to your conf.py."
-msgstr ""
+msgstr "v2.0以降、Sphinxはデフォルトで \"index \" をroot_docとして使用しています。conf.pyに \"root_doc = 'contents'\" を追加してください。"
#: sphinx/events.py:67
#, python-format
diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo
index 7b667b8331b..a15ea5b2f76 100644
Binary files a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo and b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
index 4b64730dfa0..dd14165eb70 100644
--- a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Norwegian Bokmål (Norway) (http://www.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/)\n"
@@ -1849,7 +1849,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr "Parametere"
@@ -1858,12 +1858,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr "Returnere"
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr "Retur type"
@@ -1876,7 +1876,7 @@ msgid "variable"
msgstr "variabel"
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr "funksjon"
@@ -1954,7 +1954,7 @@ msgid "Throws"
msgstr "Kaster"
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr "klasse"
@@ -1971,7 +1971,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr "%s() (innebygd funksjon)"
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr "%s() (%s metode)"
@@ -1986,7 +1986,7 @@ msgstr "%s() (klasse)"
msgid "%s (global variable or constant)"
msgstr "%s (global variabel eller konstant)"
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr "%s (%s attribut)"
@@ -2000,20 +2000,20 @@ msgstr "Argument"
msgid "%s (module)"
msgstr "%s (modul)"
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr "metode"
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr "data"
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr "attributt"
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr "modul"
@@ -2044,7 +2044,7 @@ msgstr "operator"
msgid "object"
msgstr "objekt"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr "untak"
@@ -2056,92 +2056,92 @@ msgstr "uttrykk"
msgid "built-in function"
msgstr "innebygde funksjoner"
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr "Variabler"
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr "Hever"
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr "%s() (i modul %s)"
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr "%s (i modul %s)"
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr "%s (innebygd variabel)"
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr "%s (innebygd klasse)"
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr "%s (klasse i %s)"
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr "%s() (%s klassemetode)"
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr "%s() (%s statisk metode)"
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr "Python Modulindex"
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr "moduler"
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr "Foreldet"
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr "klassemetode"
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr "statisk metode"
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr " (foreldet)"
@@ -2702,42 +2702,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2908,7 +2908,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.mo b/sphinx/locale/pl/LC_MESSAGES/sphinx.mo
index 211236fd60f..ef4e5de9cbc 100644
Binary files a/sphinx/locale/pl/LC_MESSAGES/sphinx.mo and b/sphinx/locale/pl/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.po b/sphinx/locale/pl/LC_MESSAGES/sphinx.po
index f6338072eb0..62d1fc1974f 100644
--- a/sphinx/locale/pl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pl/LC_MESSAGES/sphinx.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Polish (http://www.transifex.com/sphinx-doc/sphinx-1/language/pl/)\n"
@@ -1853,7 +1853,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr "Parametry"
@@ -1862,12 +1862,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr "Zwraca"
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr "Typ zwracany"
@@ -1880,7 +1880,7 @@ msgid "variable"
msgstr "zmienna"
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr "funkcja"
@@ -1958,7 +1958,7 @@ msgid "Throws"
msgstr "Wyrzuca"
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr "klasa"
@@ -1975,7 +1975,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr "%s() (funkcja wbudowana)"
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr "%s() (%s metoda)"
@@ -1990,7 +1990,7 @@ msgstr "%s() (klasa)"
msgid "%s (global variable or constant)"
msgstr "%s (zmienna globalna lub stała)"
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr "%s (%s atrybut)"
@@ -2004,20 +2004,20 @@ msgstr "Argumenty"
msgid "%s (module)"
msgstr "%s (moduł)"
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr "metoda"
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr "dane"
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr "atrybut"
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr "moduł"
@@ -2048,7 +2048,7 @@ msgstr "operator"
msgid "object"
msgstr "obiekt"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr "wyjątek"
@@ -2060,92 +2060,92 @@ msgstr "instrukcja"
msgid "built-in function"
msgstr "funkcja wbudowana"
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr "Zmienne"
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr "Wyrzuca"
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr "%s() (w module %s)"
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr "%s (w module %s)"
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr "%s (zmienna wbudowana)"
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr "%s (klasa wbudowana)"
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr "%s (klasa w module %s)"
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr "%s() (%s metoda klasy)"
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr "%s() (%s metoda statyczna)"
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr "Indeks modułów Pythona"
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr "moduły"
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr "Niezalecane"
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr "metoda klasy"
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr "statyczna metoda"
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr " (niezalecane)"
@@ -2706,42 +2706,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr "Stały odnośnik do tego równania"
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr "(w %s v%s)"
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr " (w %s)"
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2912,7 +2912,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt/LC_MESSAGES/sphinx.mo
index 4527290b2e3..be82068f62c 100644
Binary files a/sphinx/locale/pt/LC_MESSAGES/sphinx.mo and b/sphinx/locale/pt/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.po b/sphinx/locale/pt/LC_MESSAGES/sphinx.po
index 7d51b1e17da..ebfe56de204 100644
--- a/sphinx/locale/pt/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Portuguese (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt/)\n"
@@ -1849,7 +1849,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr ""
@@ -1858,12 +1858,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr ""
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr ""
@@ -1876,7 +1876,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr ""
@@ -1954,7 +1954,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr ""
@@ -1971,7 +1971,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -1986,7 +1986,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2000,20 +2000,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr ""
@@ -2044,7 +2044,7 @@ msgstr ""
msgid "object"
msgstr ""
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr ""
@@ -2056,92 +2056,92 @@ msgstr ""
msgid "built-in function"
msgstr ""
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr ""
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr ""
@@ -2702,42 +2702,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2908,7 +2908,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/sphinx.pot b/sphinx/locale/sphinx.pot
index 4dda3787ea0..50993c9f8a7 100644
--- a/sphinx/locale/sphinx.pot
+++ b/sphinx/locale/sphinx.pot
@@ -6,9 +6,9 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: Sphinx 4.3.0\n"
+"Project-Id-Version: Sphinx 4.4.0\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-11-07 00:10+0000\n"
+"POT-Creation-Date: 2021-11-14 00:10+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: LANGUAGE \n"
@@ -71,76 +71,76 @@ msgstr ""
msgid "loading translations [%s]... "
msgstr ""
-#: sphinx/application.py:296 sphinx/util/__init__.py:539
+#: sphinx/application.py:297 sphinx/util/__init__.py:539
msgid "done"
msgstr ""
-#: sphinx/application.py:298
+#: sphinx/application.py:299
msgid "not available for built-in messages"
msgstr ""
-#: sphinx/application.py:307
+#: sphinx/application.py:308
msgid "loading pickled environment"
msgstr ""
-#: sphinx/application.py:312
+#: sphinx/application.py:313
#, python-format
msgid "failed: %s"
msgstr ""
-#: sphinx/application.py:320
+#: sphinx/application.py:321
msgid "No builder selected, using default: html"
msgstr ""
-#: sphinx/application.py:348
+#: sphinx/application.py:349
msgid "succeeded"
msgstr ""
-#: sphinx/application.py:349
+#: sphinx/application.py:350
msgid "finished with problems"
msgstr ""
-#: sphinx/application.py:353
+#: sphinx/application.py:354
#, python-format
msgid "build %s, %s warning (with warnings treated as errors)."
msgstr ""
-#: sphinx/application.py:355
+#: sphinx/application.py:356
#, python-format
msgid "build %s, %s warnings (with warnings treated as errors)."
msgstr ""
-#: sphinx/application.py:358
+#: sphinx/application.py:359
#, python-format
msgid "build %s, %s warning."
msgstr ""
-#: sphinx/application.py:360
+#: sphinx/application.py:361
#, python-format
msgid "build %s, %s warnings."
msgstr ""
-#: sphinx/application.py:364
+#: sphinx/application.py:365
#, python-format
msgid "build %s."
msgstr ""
-#: sphinx/application.py:594
+#: sphinx/application.py:595
#, python-format
msgid "node class %r is already registered, its visitors will be overridden"
msgstr ""
-#: sphinx/application.py:672
+#: sphinx/application.py:673
#, python-format
msgid "directive %r is already registered, it will be overridden"
msgstr ""
-#: sphinx/application.py:693 sphinx/application.py:714
+#: sphinx/application.py:694 sphinx/application.py:715
#, python-format
msgid "role %r is already registered, it will be overridden"
msgstr ""
-#: sphinx/application.py:1245
+#: sphinx/application.py:1246
#, python-format
msgid ""
"the %s extension does not declare if it is safe for parallel reading, "
@@ -148,12 +148,12 @@ msgid ""
"explicit"
msgstr ""
-#: sphinx/application.py:1249
+#: sphinx/application.py:1250
#, python-format
msgid "the %s extension is not safe for parallel reading"
msgstr ""
-#: sphinx/application.py:1252
+#: sphinx/application.py:1253
#, python-format
msgid ""
"the %s extension does not declare if it is safe for parallel writing, "
@@ -161,65 +161,65 @@ msgid ""
"explicit"
msgstr ""
-#: sphinx/application.py:1256
+#: sphinx/application.py:1257
#, python-format
msgid "the %s extension is not safe for parallel writing"
msgstr ""
-#: sphinx/application.py:1264 sphinx/application.py:1268
+#: sphinx/application.py:1265 sphinx/application.py:1269
#, python-format
msgid "doing serial %s"
msgstr ""
-#: sphinx/config.py:170
+#: sphinx/config.py:171
#, python-format
msgid "config directory doesn't contain a conf.py file (%s)"
msgstr ""
-#: sphinx/config.py:197
+#: sphinx/config.py:198
#, python-format
msgid ""
"cannot override dictionary config setting %r, ignoring (use %r to set "
"individual elements)"
msgstr ""
-#: sphinx/config.py:206
+#: sphinx/config.py:207
#, python-format
msgid "invalid number %r for config value %r, ignoring"
msgstr ""
-#: sphinx/config.py:211
+#: sphinx/config.py:212
#, python-format
msgid "cannot override config setting %r with unsupported type, ignoring"
msgstr ""
-#: sphinx/config.py:240
+#: sphinx/config.py:241
#, python-format
msgid "unknown config value %r in override, ignoring"
msgstr ""
-#: sphinx/config.py:257
+#: sphinx/config.py:258
#, python-format
msgid "No such config value: %s"
msgstr ""
-#: sphinx/config.py:281
+#: sphinx/config.py:282
#, python-format
msgid "Config value %r already present"
msgstr ""
-#: sphinx/config.py:330
+#: sphinx/config.py:331
#, python-format
msgid "There is a syntax error in your configuration file: %s\n"
msgstr ""
-#: sphinx/config.py:333
+#: sphinx/config.py:334
msgid ""
"The configuration file (or one of the modules it imports) called "
"sys.exit()"
msgstr ""
-#: sphinx/config.py:340
+#: sphinx/config.py:341
#, python-format
msgid ""
"There is a programmable error in your configuration file:\n"
@@ -227,57 +227,57 @@ msgid ""
"%s"
msgstr ""
-#: sphinx/config.py:366
+#: sphinx/config.py:367
#, python-format
msgid ""
"The config value `source_suffix' expects a string, list of strings, or "
"dictionary. But `%r' is given."
msgstr ""
-#: sphinx/config.py:385
+#: sphinx/config.py:386
#, python-format
msgid "Section %s"
msgstr ""
-#: sphinx/config.py:386
+#: sphinx/config.py:387
#, python-format
msgid "Fig. %s"
msgstr ""
-#: sphinx/config.py:387
+#: sphinx/config.py:388
#, python-format
msgid "Table %s"
msgstr ""
-#: sphinx/config.py:388
+#: sphinx/config.py:389
#, python-format
msgid "Listing %s"
msgstr ""
-#: sphinx/config.py:425
+#: sphinx/config.py:426
msgid ""
"The config value `{name}` has to be a one of {candidates}, but "
"`{current}` is given."
msgstr ""
-#: sphinx/config.py:443
+#: sphinx/config.py:444
msgid ""
"The config value `{name}' has type `{current.__name__}'; expected "
"{permitted}."
msgstr ""
-#: sphinx/config.py:456
+#: sphinx/config.py:457
msgid ""
"The config value `{name}' has type `{current.__name__}', defaults to "
"`{default.__name__}'."
msgstr ""
-#: sphinx/config.py:466
+#: sphinx/config.py:467
#, python-format
msgid "primary_domain %r not found, ignored."
msgstr ""
-#: sphinx/config.py:478
+#: sphinx/config.py:479
msgid ""
"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
"\"root_doc = 'contents'\" to your conf.py."
@@ -520,103 +520,103 @@ msgstr ""
msgid "building [mo]: "
msgstr ""
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535
-#: sphinx/builders/__init__.py:561
+#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
+#: sphinx/builders/__init__.py:562
msgid "writing output... "
msgstr ""
-#: sphinx/builders/__init__.py:225
+#: sphinx/builders/__init__.py:226
#, python-format
msgid "all of %d po files"
msgstr ""
-#: sphinx/builders/__init__.py:243
+#: sphinx/builders/__init__.py:244
#, python-format
msgid "targets for %d po files that are specified"
msgstr ""
-#: sphinx/builders/__init__.py:250
+#: sphinx/builders/__init__.py:251
#, python-format
msgid "targets for %d po files that are out of date"
msgstr ""
-#: sphinx/builders/__init__.py:257
+#: sphinx/builders/__init__.py:258
msgid "all source files"
msgstr ""
-#: sphinx/builders/__init__.py:269
+#: sphinx/builders/__init__.py:270
#, python-format
msgid "file %r given on command line is not under the source directory, ignoring"
msgstr ""
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:274
#, python-format
msgid "file %r given on command line does not exist, ignoring"
msgstr ""
-#: sphinx/builders/__init__.py:284
+#: sphinx/builders/__init__.py:285
#, python-format
msgid "%d source files given on command line"
msgstr ""
-#: sphinx/builders/__init__.py:294
+#: sphinx/builders/__init__.py:295
#, python-format
msgid "targets for %d source files that are out of date"
msgstr ""
-#: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
#, python-format
msgid "building [%s]: "
msgstr ""
-#: sphinx/builders/__init__.py:310
+#: sphinx/builders/__init__.py:311
msgid "looking for now-outdated files... "
msgstr ""
-#: sphinx/builders/__init__.py:315
+#: sphinx/builders/__init__.py:316
#, python-format
msgid "%d found"
msgstr ""
-#: sphinx/builders/__init__.py:317
+#: sphinx/builders/__init__.py:318
msgid "none found"
msgstr ""
-#: sphinx/builders/__init__.py:322
+#: sphinx/builders/__init__.py:323
msgid "pickling environment"
msgstr ""
-#: sphinx/builders/__init__.py:328
+#: sphinx/builders/__init__.py:329
msgid "checking consistency"
msgstr ""
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:333
msgid "no targets are out of date."
msgstr ""
-#: sphinx/builders/__init__.py:371
+#: sphinx/builders/__init__.py:372
msgid "updating environment: "
msgstr ""
-#: sphinx/builders/__init__.py:392
+#: sphinx/builders/__init__.py:393
#, python-format
msgid "%s added, %s changed, %s removed"
msgstr ""
-#: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457
+#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
msgid "reading sources... "
msgstr ""
-#: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571
+#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
msgid "waiting for workers..."
msgstr ""
-#: sphinx/builders/__init__.py:513
+#: sphinx/builders/__init__.py:514
#, python-format
msgid "docnames to write: %s"
msgstr ""
-#: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
msgid "preparing documents"
msgstr ""
@@ -1827,22 +1827,50 @@ msgstr ""
msgid "Line spec %r: no lines pulled from include file %r"
msgstr ""
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:110
+#, python-format
+msgid "toctree glob pattern %r didn't match any documents"
+msgstr ""
+
+#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#, python-format
+msgid "toctree contains reference to excluded document %r"
+msgstr ""
+
+#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#, python-format
+msgid "toctree contains reference to nonexisting document %r"
+msgstr ""
+
+#: sphinx/directives/other.py:144
+#, python-format
+msgid "duplicated entry found in toctree: %s"
+msgstr ""
+
+#: sphinx/directives/other.py:176
msgid "Section author: "
msgstr ""
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:178
msgid "Module author: "
msgstr ""
-#: sphinx/directives/other.py:179
+#: sphinx/directives/other.py:180
msgid "Code author: "
msgstr ""
-#: sphinx/directives/other.py:181
+#: sphinx/directives/other.py:182
msgid "Author: "
msgstr ""
+#: sphinx/directives/other.py:254
+msgid ".. acks content is not a list"
+msgstr ""
+
+#: sphinx/directives/other.py:279
+msgid ".. hlist content is not a list"
+msgstr ""
+
#: sphinx/directives/patches.py:118
msgid ""
"\":file:\" option for csv-table directive now recognizes an absolute path"
@@ -1894,7 +1922,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1178
msgid "function"
msgstr ""
@@ -1972,7 +2000,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1180
msgid "class"
msgstr ""
@@ -1989,7 +2017,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:817
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -2004,7 +2032,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:902
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2018,20 +2046,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1182
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1179
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1185
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1177
+#: sphinx/domains/python.py:1187
msgid "module"
msgstr ""
@@ -2062,7 +2090,7 @@ msgstr ""
msgid "object"
msgstr ""
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1181
msgid "exception"
msgstr ""
@@ -2082,84 +2110,84 @@ msgstr ""
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
+#: sphinx/domains/python.py:662 sphinx/domains/python.py:806
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
-#: sphinx/domains/python.py:939
+#: sphinx/domains/python.py:722 sphinx/domains/python.py:898
+#: sphinx/domains/python.py:949
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:714
+#: sphinx/domains/python.py:724
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:739
+#: sphinx/domains/python.py:749
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:740
+#: sphinx/domains/python.py:750
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:811
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
+#: sphinx/domains/python.py:813 sphinx/domains/python.py:953
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:805
+#: sphinx/domains/python.py:815
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1097
+#: sphinx/domains/python.py:1107
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1098
+#: sphinx/domains/python.py:1108
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1147
+#: sphinx/domains/python.py:1157
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1183
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1174
+#: sphinx/domains/python.py:1184
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1186
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1234
+#: sphinx/domains/python.py:1244
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: "
"for one of them"
msgstr ""
-#: sphinx/domains/python.py:1354
+#: sphinx/domains/python.py:1364
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1408
+#: sphinx/domains/python.py:1418
msgid " (deprecated)"
msgstr ""
@@ -2381,16 +2409,6 @@ msgid ""
"link will be generated"
msgstr ""
-#: sphinx/environment/adapters/toctree.py:176
-#, python-format
-msgid "toctree contains reference to excluded document %r"
-msgstr ""
-
-#: sphinx/environment/adapters/toctree.py:178
-#, python-format
-msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
-
#: sphinx/environment/collectors/asset.py:90
#, python-format
msgid "image file not readable: %s"
@@ -3166,7 +3184,7 @@ msgid "page"
msgstr ""
#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
+#: sphinx/themes/basic/localtoc.html:12 sphinx/themes/scrolls/layout.html:41
msgid "Table of Contents"
msgstr ""
@@ -3291,19 +3309,19 @@ msgstr ""
msgid "Search %(docstitle)s"
msgstr ""
-#: sphinx/themes/basic/relations.html:11
+#: sphinx/themes/basic/relations.html:12
msgid "Previous topic"
msgstr ""
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:14
msgid "previous chapter"
msgstr ""
-#: sphinx/themes/basic/relations.html:16
+#: sphinx/themes/basic/relations.html:19
msgid "Next topic"
msgstr ""
-#: sphinx/themes/basic/relations.html:18
+#: sphinx/themes/basic/relations.html:21
msgid "next chapter"
msgstr ""
diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo
index d49fd4d77c5..1fc4b4dd09f 100644
Binary files a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo and b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
index e757bd8f604..9259a9616c7 100644
--- a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Ukrainian (Ukraine) (http://www.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/)\n"
@@ -1850,7 +1850,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr "Параметри"
@@ -1859,12 +1859,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr "Повертає"
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr "Тип повернення"
@@ -1877,7 +1877,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr "функція"
@@ -1955,7 +1955,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr "клас"
@@ -1972,7 +1972,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr "%s() (вбудована функція)"
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr "%s() (%s метод)"
@@ -1987,7 +1987,7 @@ msgstr "%s() (клас)"
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr "%s (%s атрибут)"
@@ -2001,20 +2001,20 @@ msgstr ""
msgid "%s (module)"
msgstr "%s (модуль)"
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr "атрибут"
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr "модуль"
@@ -2045,7 +2045,7 @@ msgstr "оператор"
msgid "object"
msgstr "об'єкт"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr "виняткова ситуація"
@@ -2057,92 +2057,92 @@ msgstr "вираз"
msgid "built-in function"
msgstr "вбудована функція"
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr ""
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr "Викликає"
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr "%s() (в модулі %s)"
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr "%s (в модулі %s)"
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr "%s (вбудована змінна)"
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr "%s (вбудований клас)"
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr "%s (клас в %s)"
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr "%s() (%s статичний метод)"
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr "модулі"
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr "Застарілий"
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr "статичний метод"
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr " (застарілий)"
@@ -2703,42 +2703,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2909,7 +2909,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.mo b/sphinx/locale/vi/LC_MESSAGES/sphinx.mo
index 0ff1c489025..ec9dd26036f 100644
Binary files a/sphinx/locale/vi/LC_MESSAGES/sphinx.mo and b/sphinx/locale/vi/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.po b/sphinx/locale/vi/LC_MESSAGES/sphinx.po
index 0d4510e4825..9558c6d8d83 100644
--- a/sphinx/locale/vi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/vi/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Vietnamese (http://www.transifex.com/sphinx-doc/sphinx-1/language/vi/)\n"
@@ -1850,7 +1850,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr "Tham số"
@@ -1859,12 +1859,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr "Trả về"
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr "Kiểu trả về"
@@ -1877,7 +1877,7 @@ msgid "variable"
msgstr "biến"
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr "hàm"
@@ -1955,7 +1955,7 @@ msgid "Throws"
msgstr "Ném"
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr "lớp"
@@ -1972,7 +1972,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr "%s() (hàm dựng sẵn)"
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr "%s() (phương thức %s)"
@@ -1987,7 +1987,7 @@ msgstr "%s() (lớp)"
msgid "%s (global variable or constant)"
msgstr "%s (biến toàn cục hoặc hằng số)"
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr "%s (thuộc tính %s)"
@@ -2001,20 +2001,20 @@ msgstr "Đối số"
msgid "%s (module)"
msgstr "%s (mô-đun)"
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr "phương thức"
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr "dữ liệu"
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr "thuộc tính"
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr "mô-đun"
@@ -2045,7 +2045,7 @@ msgstr "toán tử"
msgid "object"
msgstr "đối tượng"
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr "ngoại lệ"
@@ -2057,92 +2057,92 @@ msgstr "câu lệnh"
msgid "built-in function"
msgstr "hàm dựng sẵn"
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr "Các biến"
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr "Đưa ra"
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr "%s() (trong mô-đun %s)"
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr "%s (trong mô-đun %s)"
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr "%s (biến dựng sẵn)"
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr "%s (lớp dựng sẵn)"
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr "%s (lớp trong %s)"
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr "%s() (phương thức lớp %s)"
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr "%s() (phương thức tĩnh %s)"
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr "Chỉ Mục Mô-đun Python"
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr "các mô-đun"
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr "Sắp loại bỏ"
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr "phương thức lớp"
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr "phương thức tĩnh"
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr "(sắp loại bỏ)"
@@ -2703,42 +2703,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2909,7 +2909,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/yue/LC_MESSAGES/sphinx.mo b/sphinx/locale/yue/LC_MESSAGES/sphinx.mo
index 7e3c4d89dd0..0629892b602 100644
Binary files a/sphinx/locale/yue/LC_MESSAGES/sphinx.mo and b/sphinx/locale/yue/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/yue/LC_MESSAGES/sphinx.po b/sphinx/locale/yue/LC_MESSAGES/sphinx.po
index 08d17aa0111..e0e1628daf6 100644
--- a/sphinx/locale/yue/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/yue/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Cantonese (http://www.transifex.com/sphinx-doc/sphinx-1/language/yue/)\n"
@@ -1849,7 +1849,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr ""
@@ -1858,12 +1858,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr ""
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr ""
@@ -1876,7 +1876,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr ""
@@ -1954,7 +1954,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr ""
@@ -1971,7 +1971,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -1986,7 +1986,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2000,20 +2000,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr ""
@@ -2044,7 +2044,7 @@ msgstr ""
msgid "object"
msgstr ""
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr ""
@@ -2056,92 +2056,92 @@ msgstr ""
msgid "built-in function"
msgstr ""
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr ""
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr ""
@@ -2702,42 +2702,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2908,7 +2908,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo
index b1c3bb9bd30..2505409731f 100644
Binary files a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo and b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo differ
diff --git a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
index 6979d3ce1b7..af8971fb5f4 100644
--- a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2021-10-31 00:10+0000\n"
+"POT-Creation-Date: 2021-11-07 00:10+0000\n"
"PO-Revision-Date: 2021-10-10 00:10+0000\n"
"Last-Translator: Komiya Takeshi \n"
"Language-Team: Chinese (Taiwan) (Big5) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW.Big5/)\n"
@@ -1849,7 +1849,7 @@ msgid "%s (C %s)"
msgstr ""
#: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177
-#: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736
msgid "Parameters"
msgstr ""
@@ -1858,12 +1858,12 @@ msgid "Return values"
msgstr ""
#: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428
+#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432
msgid "Returns"
msgstr ""
#: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:430
+#: sphinx/domains/python.py:434
msgid "Return type"
msgstr ""
@@ -1876,7 +1876,7 @@ msgid "variable"
msgstr ""
#: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164
+#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168
msgid "function"
msgstr ""
@@ -1954,7 +1954,7 @@ msgid "Throws"
msgstr ""
#: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1166
+#: sphinx/domains/python.py:1170
msgid "class"
msgstr ""
@@ -1971,7 +1971,7 @@ msgstr ""
msgid "%s() (built-in function)"
msgstr ""
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803
+#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807
#, python-format
msgid "%s() (%s method)"
msgstr ""
@@ -1986,7 +1986,7 @@ msgstr ""
msgid "%s (global variable or constant)"
msgstr ""
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888
+#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892
#, python-format
msgid "%s (%s attribute)"
msgstr ""
@@ -2000,20 +2000,20 @@ msgstr ""
msgid "%s (module)"
msgstr ""
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168
+#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172
msgid "method"
msgstr ""
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165
+#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169
msgid "data"
msgstr ""
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171
+#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175
msgid "attribute"
msgstr ""
#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1173
+#: sphinx/domains/python.py:1177
msgid "module"
msgstr ""
@@ -2044,7 +2044,7 @@ msgstr ""
msgid "object"
msgstr ""
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1167
+#: sphinx/domains/python.py:62 sphinx/domains/python.py:1171
msgid "exception"
msgstr ""
@@ -2056,92 +2056,92 @@ msgstr ""
msgid "built-in function"
msgstr ""
-#: sphinx/domains/python.py:421
+#: sphinx/domains/python.py:425
msgid "Variables"
msgstr ""
-#: sphinx/domains/python.py:425
+#: sphinx/domains/python.py:429
msgid "Raises"
msgstr ""
-#: sphinx/domains/python.py:648 sphinx/domains/python.py:792
+#: sphinx/domains/python.py:652 sphinx/domains/python.py:796
#, python-format
msgid "%s() (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:708 sphinx/domains/python.py:884
-#: sphinx/domains/python.py:935
+#: sphinx/domains/python.py:712 sphinx/domains/python.py:888
+#: sphinx/domains/python.py:939
#, python-format
msgid "%s (in module %s)"
msgstr ""
-#: sphinx/domains/python.py:710
+#: sphinx/domains/python.py:714
#, python-format
msgid "%s (built-in variable)"
msgstr ""
-#: sphinx/domains/python.py:735
+#: sphinx/domains/python.py:739
#, python-format
msgid "%s (built-in class)"
msgstr ""
-#: sphinx/domains/python.py:736
+#: sphinx/domains/python.py:740
#, python-format
msgid "%s (class in %s)"
msgstr ""
-#: sphinx/domains/python.py:797
+#: sphinx/domains/python.py:801
#, python-format
msgid "%s() (%s class method)"
msgstr ""
-#: sphinx/domains/python.py:799 sphinx/domains/python.py:939
+#: sphinx/domains/python.py:803 sphinx/domains/python.py:943
#, python-format
msgid "%s (%s property)"
msgstr ""
-#: sphinx/domains/python.py:801
+#: sphinx/domains/python.py:805
#, python-format
msgid "%s() (%s static method)"
msgstr ""
-#: sphinx/domains/python.py:1093
+#: sphinx/domains/python.py:1097
msgid "Python Module Index"
msgstr ""
-#: sphinx/domains/python.py:1094
+#: sphinx/domains/python.py:1098
msgid "modules"
msgstr ""
-#: sphinx/domains/python.py:1143
+#: sphinx/domains/python.py:1147
msgid "Deprecated"
msgstr ""
-#: sphinx/domains/python.py:1169
+#: sphinx/domains/python.py:1173
msgid "class method"
msgstr ""
-#: sphinx/domains/python.py:1170
+#: sphinx/domains/python.py:1174
msgid "static method"
msgstr ""
-#: sphinx/domains/python.py:1172
+#: sphinx/domains/python.py:1176
msgid "property"
msgstr ""
-#: sphinx/domains/python.py:1230
+#: sphinx/domains/python.py:1234
#, python-format
msgid ""
"duplicate object description of %s, other instance in %s, use :noindex: for "
"one of them"
msgstr ""
-#: sphinx/domains/python.py:1350
+#: sphinx/domains/python.py:1354
#, python-format
msgid "more than one target found for cross-reference %r: %s"
msgstr ""
-#: sphinx/domains/python.py:1404
+#: sphinx/domains/python.py:1408
msgid " (deprecated)"
msgstr ""
@@ -2702,42 +2702,42 @@ msgstr ""
msgid "Permalink to this equation"
msgstr ""
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
#, python-format
msgid "intersphinx inventory has moved: %s -> %s"
msgstr ""
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
#, python-format
msgid "loading intersphinx inventory from %s..."
msgstr ""
-#: sphinx/ext/intersphinx.py:218
+#: sphinx/ext/intersphinx.py:219
msgid ""
"encountered some issues with some of the inventories, but they had working "
"alternatives:"
msgstr ""
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
msgid "failed to reach any of the inventories with the following issues:"
msgstr ""
-#: sphinx/ext/intersphinx.py:334
+#: sphinx/ext/intersphinx.py:270
#, python-format
msgid "(in %s v%s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:336
+#: sphinx/ext/intersphinx.py:272
#, python-format
msgid "(in %s)"
msgstr ""
-#: sphinx/ext/intersphinx.py:369
+#: sphinx/ext/intersphinx.py:476
#, python-format
msgid "intersphinx identifier %r is not string. Ignored"
msgstr ""
-#: sphinx/ext/intersphinx.py:382
+#: sphinx/ext/intersphinx.py:489
#, python-format
msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
msgstr ""
@@ -2908,7 +2908,7 @@ msgid ""
" Please update your setting."
msgstr ""
-#: sphinx/ext/autodoc/preserve_defaults.py:78
+#: sphinx/ext/autodoc/preserve_defaults.py:106
#, python-format
msgid "Failed to parse a default argument value for %r: %s"
msgstr ""
diff --git a/sphinx/themes/basic/localtoc.html b/sphinx/themes/basic/localtoc.html
index d761c23787d..750f5daa02d 100644
--- a/sphinx/themes/basic/localtoc.html
+++ b/sphinx/themes/basic/localtoc.html
@@ -8,6 +8,8 @@
:license: BSD, see LICENSE for details.
#}
{%- if display_toc %}
-
- {{ toc }}
+
{%- endif %}
diff --git a/sphinx/themes/basic/relations.html b/sphinx/themes/basic/relations.html
index c4391fe4d40..db478b71938 100644
--- a/sphinx/themes/basic/relations.html
+++ b/sphinx/themes/basic/relations.html
@@ -8,12 +8,16 @@
:license: BSD, see LICENSE for details.
#}
{%- if prev %}
- {{ _('Previous topic') }}
- {{ prev.title }}
+
{%- endif %}
{%- if next %}
- {{ _('Next topic') }}
- {{ next.title }}
+
{%- endif %}
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index 7e45fe32226..3a39bde1d6b 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -19,8 +19,7 @@
import warnings
from functools import partial, partialmethod
from importlib import import_module
-from inspect import (Parameter, isasyncgenfunction, isclass, ismethod, # NOQA
- ismethoddescriptor, ismodule)
+from inspect import Parameter, isclass, ismethod, ismethoddescriptor, ismodule # NOQA
from io import StringIO
from types import ModuleType
from typing import Any, Callable, Dict, Mapping, Optional, Sequence, Tuple, Type, cast
@@ -408,6 +407,16 @@ def iswrappedcoroutine(obj: Any) -> bool:
return False
+def isasyncgenfunction(obj: Any) -> bool:
+ """Check if the object is async-gen function."""
+ if hasattr(obj, '__code__') and inspect.isasyncgenfunction(obj):
+ # check obj.__code__ because isasyncgenfunction() crashes for custom method-like
+ # objects on python3.7 (see https://github.com/sphinx-doc/sphinx/issues/9838)
+ return True
+ else:
+ return False
+
+
def isproperty(obj: Any) -> bool:
"""Check if the object is property."""
if sys.version_info >= (3, 8):
diff --git a/tests/test_build_html.py b/tests/test_build_html.py
index 106ad047009..a1d4717e77d 100644
--- a/tests/test_build_html.py
+++ b/tests/test_build_html.py
@@ -225,9 +225,9 @@ def test_html4_output(app, status, warning):
(".//a[@href='https://www.python.org/dev/peps/pep-0008']"
"[@class='pep reference external']/strong",
'Python Enhancement Proposal #8'),
- (".//a[@href='https://tools.ietf.org/html/rfc1.html']"
+ (".//a[@href='https://datatracker.ietf.org/doc/html/rfc1.html']"
"[@class='rfc reference external']/strong", 'RFC 1'),
- (".//a[@href='https://tools.ietf.org/html/rfc1.html']"
+ (".//a[@href='https://datatracker.ietf.org/doc/html/rfc1.html']"
"[@class='rfc reference external']/strong", 'Request for Comments #1'),
(".//a[@href='objects.html#envvar-HOME']"
"[@class='reference internal']/code/span[@class='pre']", 'HOME'),
diff --git a/tests/test_markup.py b/tests/test_markup.py
index f8fff1c2d03..b3960bc5ebd 100644
--- a/tests/test_markup.py
+++ b/tests/test_markup.py
@@ -36,7 +36,7 @@ def settings(app):
settings.env = app.builder.env
settings.env.temp_data['docname'] = 'dummy'
settings.contentsname = 'dummy'
- settings.rfc_base_url = 'http://tools.ietf.org/html/'
+ settings.rfc_base_url = 'http://datatracker.ietf.org/doc/html/'
domain_context = sphinx_domains(settings.env)
domain_context.enable()
yield settings
@@ -181,10 +181,10 @@ def get(name):
'verify',
':rfc:`2324`',
('RFC 2324
'),
+ 'href="http://datatracker.ietf.org/doc/html/rfc2324.html">RFC 2324
'),
('\\sphinxAtStartPar\n'
'\\index{RFC@\\spxentry{RFC}!RFC 2324@\\spxentry{RFC 2324}}'
- '\\sphinxhref{http://tools.ietf.org/html/rfc2324.html}'
+ '\\sphinxhref{http://datatracker.ietf.org/doc/html/rfc2324.html}'
'{\\sphinxstylestrong{RFC 2324}}')
),
(
@@ -192,11 +192,11 @@ def get(name):
'verify',
':rfc:`2324#id1`',
(''
+ 'href="http://datatracker.ietf.org/doc/html/rfc2324.html#id1">'
'RFC 2324#id1
'),
('\\sphinxAtStartPar\n'
'\\index{RFC@\\spxentry{RFC}!RFC 2324\\#id1@\\spxentry{RFC 2324\\#id1}}'
- '\\sphinxhref{http://tools.ietf.org/html/rfc2324.html\\#id1}'
+ '\\sphinxhref{http://datatracker.ietf.org/doc/html/rfc2324.html\\#id1}'
'{\\sphinxstylestrong{RFC 2324\\#id1}}')
),
(